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Introduction 



You finally ma.. *he u.vision to buy a personal computer, you bring 
home your new macule - and the first question your friends ask is 
"What can it do?" Soon this question begins to annoy you, and you 
too begin to wonder: "Have I just been taken in by a trend or do 
I truly have a machine that can do somettdng useful?" 

In my early years working with personal computers I never really 
questioned their usefulness. I simply loved using and pro t camming 
computers. I recall my first computer fondly, in spite of iis pitiful 
graphics, inadequate sound, and its mere 16,000 bytes of memory. 
And yet, when I discovered how to use machine language to make 
the computer beep out a few notes of "The Yellow Rose of Texas," 
I was ecstatic. But after writing my first few computer books, I beg?n 
to realize that the home computers being sold at that time weren't 
very useful for most people. The irony of that discovery was that I 
had been preaching through my books how wonderful computers 
were for ordinary people. 

The computer industry has come a long way since then, and today 
I no longer have to question the usefulness or value of personal 
computers. The technology has progressed very quickly, bringing to 
the public such machines as the Apple II®, the IBM® PC, and the 
Macintosh™. These computers were major milestones in the indus- 
try, and each machine that was introduced had capabilities that were 
improvements over its predecessor. In particular, significant im- 
provements were made in the areas of graphics, sound, speed, mem- 
ory capacity, and mass storage capability. 

Among these new computers, the Amiga™ from Commodore-Amiga, 
Inc., stands out as one of the most powerful and exciting personal 
computers in existence today. The more you know about computers, 
the more astounded you are at all the Amiga is capable of doing. ' 
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What Are the Amiga's 
Capabilities? 

Marking another major milestone in the personal computer industry, 
the Amiga features many powerful capabilities at a tow cost. Among 
the Amiga's capabilities are 

• High-resolution graphics with 4,096 available colors 

• &>i "if* and music generation in stereo with as many as 
fou "voxc*" (channels) 

• Easy operatic/ with the mouse 

• A full 51 2K of user memory 

• A complete keyboard with cursor -control keys and a 
numeric keypad 

• The sophisticated and powerful 68000 Motoroh. 
microprocessor 

Two of the Amiga's strengths are particularly outstanding: graphics 
and sound capabilities. Graphics are the pictures the computer can 
produce on the screen. By using the Amiga's graphics commands, 
you can draw a variety of shapes and colors on the screen w»th 
surprising ease. The sounds you can produce with the Amiga can 
be sound effects in a game or musical pieces. You can create music 
using as many as four separate instruments playing simultaneously. 
To program the computer to make graphics and sounds and to serve 
other useful functions, you need to learn the fundamentals of three 
computer languages: Amiga BASIC, TLC Logo, and C. The Amiga 
Programming Guide concentrates on the Amiga's graphics and 
sound capabilities, as well as on the computer languages you need 
to learn to use the Amiga. 

What Does This Book Contain? 

This book is organized so that you gradually learn about program- 
ming as you work your way through each chapter. You need not 
be an expert in computer programming in order to learn from this 
book because it is a tutorial, not a reference guide. Through pro- 
gramming examples and descriptions of keywords (specific words 
in a computer language that cause the computer to perform tasks), 
you can learn, step-by-step, the fundamentals of programming. This 



INTRODUCTION 



3 



knowledge will give you the basic foundation, from which you can 
use your own imagination to build and create more powerful pro- 
grams. A brief overview of the material presented in this book 
follows. 

In Chapter 1, "Introducing the Amiga," you will learn how to set 
up the Amiga, use the mouse and keyboard, and use the Workbench 
program 

Chapter 2 provides an introduction to the fundamental concepts of 
programming in Amiga BASIC, the language that comes with your 
computer. You will learn aboi -t lint numbers, variables, and some 
simple commands. 

Chapter 3, "Advanced Amiga BASIC," provide explanations of vari- 
able arrays, program development, and other more advanced topics. 
The material in this chapter will help you begin writing LX'e so- 
phisticated programs. 

Because much of the Amiga's power is in its graphics capability, all 
of Chapter 4 is devoted to Amiga BASIC'S graphics commands and 
ways to use them. 

You easily can produce sounds, music, and speech through Amiga 
BASIC commands. In Chapter 5, "Sounds, Music, and Speech," you 
wiil If am how to use these commands in your own programs. 

Chapter 6 teaches you the basics of Logo. This language is popular 
both for children and adults who are interested in artificial intel- 
ligence. Even if you don't own a Logo software package, you still 
can profit from a look at how another programming language works. 

C is a fast, powerful language that is popular among professional 
programmers. Chapter 7, "Programming in C," gives you a brief 
introduction to the language and explains what you will need to 
use it " 

Chapter 8, "Using AmigaDOS," explains the disk operating system 
that is included with your Amiga's software. AmigaDOS can help you 
manage your computer's information efficiently. 

To learn even more advanced commands for the disk operating sys- 
tem, you can explore the commands and DOS program descriptions 
presented in Chapter 9, "Advanced AmigaDOS." 

Finally, Chapter 10, "Amiga at Work and Play," contains information 
that can help you make the Amiga a useful tool for your home or 

oflS««i Tluo thaptir aloo oflfcio l d t-iun for uciiiig j uui Amiga fur til- 
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tertainment. Once you understand all that the Amiga is capable of 
doing, you will be able to answer confidently the question "What 
can it do?" The power of the Amiga is immense, and after you have 
finished reading this book, you will have the knowledge to begin 
tapping that power. 



1 

Introducing the Amiga 



The Amiga is one of today's most sophisticated personal computers 
for the home and for the small business (see fig. 1.1), This computer 
features unparalleled graphics, versatile sounds and music, easy-to- 
use input and output devices, a fast microprocessor, and a library 
of powerful soi'rware. The combination of these features, made pos- 
sible by recent advances in high technology, make this computer an 
excellent value. 



Fig. LI. The Amiga. 




Although the manual that comes with the Amiga system provides 
general instructions for setting up the system, using the Work- 
bench© ana programming in Amiga BASIC, these items- as well as 
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other topics— are covered in much more detail in this book. In this 
chapter, you will learn how to set up the Amiga; how to use the 
keyboard, the disks, and the mouse; and how to start running the 
computer. 

Setting Up the Amiga 

Before setting up the computer, you must find a place to put it. 
Although this may seem to be a minor topic, giving the location 
some advance thought can prevent cost!/ acc^euts and aching 
backs. Some important requirements for the iv.. * ! ou of the com- 
puter are the following: 

1. The surface should be smooth and flat with plenty of 
room for laying down such items as books, diskettes, 
and program listings. 

2 The location should be near an electrical outlet so that 
i je computer can be plugged in without the risk of 
someone's tripping over the cord and pulling out the 
plug. 

3. Your computer workstation should be equipped with a 
comfortal;i~ chair, preferably an adjustable office chair 
like you would use at a typewriter table. If you spend a 
few hours at your computer sitting on the old dining 
room chair, the ache in your back will tell you why an 
appropriate chair is important for your workstation. A 
comfortable office chair, which has adjustable height 
and back support, puts minimum stress on your back. 
Adjustable office chairs are available in most office 
supply centers for less than $100. 

4. If possible, your electrical outlet should be equipped 
with a surge protector, which you can purchase at 
most computer outlets. This device eliminates the 
changes in electrical power that can cause loss of 
information in the computer's memory. 

Components 

Once you have designated an appropriate workstation, you can begin 
to arrange the computer's components and to make the necessary 
hookups, ine Amiga computer comes wlin me following 
components: 
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The main computer unit and power cord: The main unit 
contains all the hardware of the computer. The 
microprocessor, memory, input/output electronics, and the 
rest of the actual computer are housed in this case. 

The keyboard and cable: The Amiga keyboard resembles a 
typewriter keyboard but has extra keys, such as the numeric 
keypad, function keys, and other special keys. 

The mouse: To move the computer's pointer around the 
screen, you use the mouse. By moving the pointer to 
selections on the screen and pressing the left button on the 
mouse, you can select options and open programs easily. 

Three disks: Included with your Amiga system are three 
disks: Kickstart®, which gets the computer running when 
you first tun: it on; Workbench, the "home base" for getting 
other programs up and running; and Amiga Extras, which 
has the Amiga Tutor and the Amiga BASIC programming 
language. 
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Hookups 

When you have all your components out of their cartons, you can 
begin setting up the Amiga and making the necessary hookups. Fol- 
low these instructions in the order given, and in a few minutes your 
Amiga will be up and running. (Refer to fig. 1.2 for the locations 
of the connectors.) 

1. Place the main computer unit on the desk that you will 
be using. Make sure that the slot for the disk drive is 
facing you. Now take the cable for the keyboard (the 
one that resembles a telephone cord) and plug the 
straight end into the leftmost connector on the back of 
the main computer unit. 

2. Set the keyboard (so that it faces you) in front of the 
Amiga and p'ug the free end of the keyboard cable into 
the connector located on the extreme left side of the 
back of the keyboard. The keyboard is now hooked up 
to the Amiga, and yot; «jan tuck the keyboard cord 
underneath the main computer unit, which has an 
opening for the cab'c to pass through. 

If you want to tilt the keybosrd, put down the legs on 
the right and left sides underatadi the keyboard. When 
you put these legs back up (so that the keyboard lies 
flat), you can slip the keyboard completely underneath 
the main computer unit for storage. This feature is 
convenient if you need the extra space when the 
computer is turned off. 

3. Now take the mouse and set it on the desk to the right 
of the keyboard. (If you are left-handed, you can place 
the mouse on the left side if you prefer.) Plug the end 
of the mouse's cord into the connector labeled "1" on 
the right side of the main computer unit. Your mouse 
is now attached and ready to use. 

When you start using the computer, you may discover 
that the computer is sluggish and is not as responsive 
to the mouse as you would like. If the problem stems 
from the computer not being sensitive to the mouse's 
movements, you can solve this problem easily; see the 
section titled "The Preferences Tool" later in this 
chapter. 
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connecting a television to a computer vary from TV to 
TV, so check the instructions that come with the 
modulator to find the proper procedure. 

5. Now you are ready to bring the Amiga to life. Plug the 
six-sided plug on the power cable into the 
corresponding connector on the back of the main 
computer unit; then plug the other end into a three- 
prong electrical outlet. To turn on your computer, flip 
the .witch on the left side of the main computer unit. 

"-^nntc'Mg a stereo to the Amiga is optional. If you do 
so, no> *wer, you can enjoy the results of the programs 
in Chapter > in .stereo sound. To hook up your stereo, 
get two phono cables and, on the back of the main 
computer unit, plug one of ^hem into the circular 
connector for the left stereo channel and plug the 
other into the circular connector for the right stereo 
channel (see fig. 1.2). Then take the other mds of 
each cable and plug them into the correspt r> ding input 
connectors of your stereo system. 

Important Dos and Don'ts 

Before you go any farther, stop and memorize the following three 
rules for using your Amiga. Learn and live by these rules, or else 
you will find yourself with a trashed disk or computer. 

If you have just turned off your computer, wait five seconds before 
turning it on again. 

Never do a software reset when a disk— especially the Workbench 
disk — is running. 

A software reset, which you do by pressing the CTRL key and two 
Amiga keys simultaneously, is a sort of "panic button." You use this 
procedure to get out of any mess you may get into with the Amiga 
(such as when the Amiga gets stuck in a routine). Pressing CTRL 
and the two Amiga keys is fine as long as the disk drive isn't running. 
If the disk drive is running, you could accidentally wipe out your 
information and programs. 

Never remove a disk when the disk drive is running. 

If your files are not closed and you remove the diskette, it will be 

rendered uaclcao. Therefore, whenever the diskdriv* is nmning—tlie 
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Function Keys 




Key Fig. 1.3- The keyboard. 



document around, or saving and loading files. In a business 
program, however, the function keys may be used for 
adding columns of figures and doing mathematical 
operations. The documentation provided with the specific 
software tells you what functions, if any, the function keys 
serve. 

Cursor-movement keys: To move the blinking cursor (the 
blinking box showing where you are working on the 
screen), use these up-, down-, left-, and right-arrow keys. As 
mentioned earlier, these keys also are used with the Amiga 
keys and the SHIFT key to move the pointer around the 
screen without using the mouse. 

CAPS LOCK: If you want to type all capital letters, press this 
key. The red LED built inside the key will light up. When 
you want to go back to regular uppercase and lowercase 
letters, press this key again, and the light will turn off 
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Other special keys: Like the function keys, a number of 
other keys perform different tasks, depending on the 
software running on the computer. These keys include the 
CTRL (Control), ALT (Alternate), Amiga, and ENTER keys. 
Others special keys are ESC (Escape), which usually gets 
you out of whatever function or program you are in, and 
BACKSPACE, which moves the cursor back one space, 
removing the character the cursor lands on. 

The Disk Drive and Diskettes 

One of the most important input/output devices L vour ^miga is 
the disk drive. The small 3 1/2-inch diskette that your A^i'oa uses 
holds more than 800,000 pieces of information. 

To help you avoid accidentally erasing an important file or copying 
over data, the diskette comes with a protect tab. By shifting this tab, 
you can protect or unprotect the diskette. If you don't want the disk 
drive to w.ite anything on a diskette, move the protect tab toward 
the top of die diskette (so that you can see through the small hole 
in its upper right corner). If you don't want the diskette to be write- 
protected close the hole by pushing the protect tab back down. 

The diskette is delicate and should be handled carefully. Although 
the diskette itself is scaled and protected from the outside envi- 
ronment by its metal slide, you still should not subject the diskette 
to heat, any kind of magnets (which include telephones, speakers, 
and motors), or smoke. Also, be sure that you never touch the actual 
diskette after moving the metal slide and exposing the plastic dis- 
kette itself. Touching the diskette almost definitely will ruin it. 

The Mouse 

Another important input device is the mouse— a pointing device that 
translates your movements into movements for the pointer on the 
screen The mouse works by detecting the movement of a rub- 
ber ball inside the mouse; as the ball rolls in a certain direction, 
the mouse translates the direction into a change in the x- and y- 
coordinates of the pointer on the screen. 

To keep the mouse in good working order so that your computer 
does not respond sluggishly, you need to give the mouse special 
care. Every couple of weeks, you should go through the following 
procedure: 
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1. Turn the mouse upside down and slide the piece of 
plastic holding the ball inside the mouse. 

2. Lift the piece of plastic off the mouse. • 

3. Turn the mouse over and catch the ball. 

4. Moisten a cotton swab with alcohol or a window- 
cleaning solution and clean the rollers inside the 
mouse where the ball used to be. 

5. Wipe off the rubber ball and repl*c* '* ir>side the 
mouse; put the plastic cover back . 

Running the Amiga 

When your Amiga is first turned on, you should see a graphics picture 
of a hand holding a disk called Kickstart. This picture is your signal 
to p 't the Kickstart disk in the drive. Insert the Kickstart disk with 
the Aetal slide facing forward and the label facing up. (This is the 
way you insert all disks.) 

Alter you insert the disk, the Amiga reads from the Kickstart disk. 
The disk drive light stays on as long as the program is reading. In 
a few seconds, another hand appears on the screen; this hand is 
holding a Workbench disk (see fig. 1.4). Make sure that the drive 
light is off and then eject the Kickstart disk by pressing the button 
on the front of the disk drive. Insert the Workbench disk In a few 
moments, the screen displays a title bar and a Workbench disk icon. 
(An icon is a picture representing a program or some other disk or 
file.) 

Now work with the mouse for a few moments to get familiar with 
its operation. The mouse is your key to easy control of the Work- 
bench features. Try moving the mouse around on a flat surface, and 
watch how the arrow on the screen moves relative to your move- 
ments. When you move the mouse away from you, the pointer arrow 
moves up the screen; when you move the mouse around in a circular 
motion, the arrow moves in the same way. The arrow will not go 
beyond the boundaries of the screen. If you need to move the arrow 
farther than the space on your desk allows, simply lift the mouse 
up and move it over. For instance, if you want to move the arrow 
to the extreme left, but your keyboard prevents you from moving 
the mouse any farther to the left, you simply lift the mouse up and 

act it down aa far to the right as you can. You then have room to 
go to the left again. After you have worked with the mouse for a 
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Fig. 1.4. Icon telling yon to 
insert the Workbench disk. 




while, the movements will become natural, and you will wonder 
how computer owners ever managed without a mouse. 

You use the buttons on the mouse to select items. You almost always 
will be using the left button. Assume Jis! you want to select an icon 
from the Workbench disk. Using the mouse, you move the arrow 
to the Workbench icon and click the left mouse button. This action 
inverts the icon and tells the computer you have selected that icon. 
However, nothing happens until you open the icon. To open the 
icon, you press the left mouse button twice without pausing between 
clicks (double-click). The Workbench disk icon then explodes into 
a window where you can see a directory of all the files on that disk 

Go ahead and use the mouse to point to the Workbench disk icon. 
The pointer must be pointing to some specific part of the disk icon, 
not just in its general direction. Once you have positioned the 
pointer on the icon, double-click the left mouse button and watch 
as the window forms out of the exploding icon. 

Another use of the left mouse button is to drag an icon. As the term 
suggests, dragging an icon means that you pull it around on the 
screen. For example, if you have a file you want to put in the trash, 
you move the arrow to the file's icon, hold down the left mouse 
button, and move the mouse to drag that icon to the Trash can. The 
file then is disposed of. Try moving the icons that are in the window. 
Don't move the icons outside of the window, and don't put any of 
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them on top of the Trashcan (or they might get destroyed acci- 
dentally). Just move the icons around a bit until you see how the 
dragging process works. 

Using certain keys on the keyboard, you can accomplish many tasks 
without using the mouse. (You may want to do this, for instance, 
if your mouse is broken.) Notice the red A Amiga keys to the right 
and left of the space bar on the keyboard. To move the pointer, 
press either Amiga key with one of the cursor-movement keys (the 
keys with up, down, left, and right arrows). To select an icon, you 
position the pointer on the icon and press the left Amiga key with 
the left ALT key. To open a file, you hold down the left AIT key 
and quickly press the left Amiga key twice. To speed up the move 
ment of the pointer, you can hold down the SHIFT key while you 
use the Amiga and cursor-movement keys. 

The Menu Bar 

Select the icon for the Workbench disk and press the right mouse 
button. Now notice the Menu Bar that appears on the top of the 
screen. On the Merm Bar are the words Uorkbench, Disk, and Spe- 
cial. These menu titles are positioned over three invisible menus. 
You can make these menus visible by holding down the right button 
on the mouse while pointing to a menu title (see fig. 1.5). 
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When you pull down the Workbench menu, you see the following 
choices: 

Open Opens the icon selected * 

Close Closes the file or disk you are working with 

Duplicate Makes a copy of a disk 

Rename Changes the name of the icon or disk 

Info Gives you information regarding the current 

disk or program 

Dii. -*H Throws away the icon you have selected 

Because having backup copies of your disks is so important, the 
Duplicate command deserves special attention. As I mentioned ear- 
lier in this chapter, I once accidentally destroyed my Workbench 
disk. If I had made a backup of Workbench, I would not have had 
any problem; instead, I had to make a trip to the dealer to get another 
copy of the disk. In any situation, you should have your own backup 
copy of a disk. 

When you choose Duplicate, the computer tells you when and how 
often to swap the disks in order to finish the copy. The computer 
guides you through the entire copjing process by instructing you 
which disk to insert or eject at any one time. (If you art jfcnimate 
enough to have a two disk drive system, you do not need to worry 
about swapping disks in and out of the drive. You simply drag the 
file's icon to the second disk drive icon and follow the menus.) 

The menu under Disk offers the following options: 

Empty Trash Permanently gets rid of the unwanted files you 
have put into the Trashcan. The Trashcan icon 
must be selected with the mouse before this 
command will work. 

Initialize Formats a new disk or erases an old one 

completely. Be careful when you choose this 
option; if you go through with this selection, 
you will erase all the data on the disk in the 
drive. 

Under Special, you have these menu options: 

Clean Up Neatly arranges the icons in a window 
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window around to different parts of the screen. In the 
middle of the Drag Bar is the Disk Identifier, which tells 
you the name of the diskette. 

Sizing Gadget: At the lower right corner of the window is 
che Sizing Gadget, which lets you shrink or expand the 
window, Point to the Sizing Gadget, hold down the left 
mouse button, and move the mouse. The size of the 
window chang es on your screen. You can make the window 
wide and saor* uU and thin, or very big. 

Disk Gauge: w 'he left side of the window is a "fuel 
meter" for each disked-. The Disk Gauge indicates how full 
the diskette is. When the Disk Gauge shows that your 
diskette is nearly full, you should begin using another 
diskette in order to ensure that you have plenty of room to 
work with. 

Scroll Arrows: In the corners of the window are arrow s 
pointing left, right, up, and down. You can move the 
contents of the window around by pointing to an arrow and 
holding down the left mouse button. If, for example, /ou 
can't see all the files in a window because they stretch 
beyond its boundaries, you can point to the appropriate 
arrow (corresponding to the direction you want the 
contents of the window to move) and hold down the left 
mouse button. 

Back and Front Gadgets: Windows often overlap one 
another. If you want the current window to be in front of 
another window, move the pointer to the Front Gadget, 
located in the upper right corner of the current window, 
and click the left mouse button. If you want the current 
window to hide behind another window, select the Back 
Gadget box just to the left of the Front Gadget box. 

You will sometimes see on the window a puffy icon filled with Zs. 
This icon indicates that your Amiga is busy with an operation and 
can't be interrupted. When the computer is ready to respond to 
your commands again, the snoring icon changes back to a regular 
pointer. 
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Manipulating Windows 

To make sure that you have a good understanding of windows, use 
the mouse to open the drawer called Demos. Then open all three 
program icons in the Demos window: Dotty Window, Boxer Win- 
dow, and Lines Window. The Dotty Window draws randomly col- 
ored dots inside the window; the Boxer Window draws randomly 
colored boxes inside the window; and the Lines Window draws 
random lines bouncing around the window. The functions of all 
three windows go on simultaneously (se* Zg, 17). which demon- 
strates the important concept of multitask; ? the computer's ca- 
pability to carry on more than one function at a iu.^ Multitasking 
is possible on the Amiga because of an advanced coprocessor chip, 
which is important to you in only one respect: you can get several 
things done at once. For instance, you can receive a program over 
the telephone line, work on a spreadsheet, and print a letter all at 
once. 




Go ahead and experiment with these three windows. Move them 
around, expand them, overlap them, and do whatever else you think 
would be fun and would help you learn more about the functions 
of windows. Once you have finished experimenting, close the three 
program windows one at a time. 
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Transferring Files 

When you have more than one window on the screen, you can 
transfer files from one window (which might represent a disk or 
drawer) to another. For instance, if you are working with a single 
disk dnve system, and you want to copy the program POLYSCOPE 
f° m ° ne J* to "oaw. You simply drag the POLYSCOPE icon 
from one disk window to the other disk window. The computer 
then gives you instructions that tell you what disk to insert at what 
Z t0 C ° Py * e ^LY^pk file to another disk. Keep in 
mind that when you copy the program, .^OLYSCOPE still will be on 
the first disk as well as on the seconu. 

You can manipulate more than one icon at a time also. For example 
to open tec drawers, you simply hold down the SHIFT key and 
double-click the mouse button on each drawer. All three icon, arc 
selected and act as one when you perform the next function. 

The Workbench Tools 

In the Workbench window are three icon tools that you can use 
eSLcs *oc? eSC Cl0Ck tOGl ' ^ N ° tepad t0 ° l ™ d Pref " 

The Clock Tool 

veXn haV l d ° Sed * e Dcmos so that no more windows 

teein !LTh SCTeen (CXCept ° ne for ^ Workbench disk 

Scf theT,f " m ° US K t0 ^ t0 CI ° Ck 1001 and dou ble- 
chck the left mouse button. A large analog clock will appear on the 

^reea You can display this clock in digital or analog and 12- or 

24-hour mode, and you can even set the alarm. Choose the options 

fust a^T k T ^ by CUddn Z ** ^ — ^ttoa 

s ~t o ^ c r e e * ° r m ° ved > - - — 

The Notepad Tool 

In the Utilities drawer is the Notepad tool, which you can use to 
store short notes and documents. Open the Utilities drawer then 

2S? £L 25 ad tOGl by double cUddnfi Y ™ °» 

rtglK a^y, and your words will appear on the Notepad Y<T«2 
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go forward a page by clicking the small triangle at the lower left 
corner of the paper, and you can move back to the preceding page 
by clicking the triangle at the upper right corner of the paper. By 
using the right mouse button, you will discover a wide variety of 
Notepad menu options. 

The first of the Notepad menu options is Project. Here is a list of 
the Project Menu Bar options and their functions: 

New Starts a new document 

Open Loads a document from the disk into memory 

Save Saves the current document under its present 

file name 

Save As Saves the current document under a file name 
that you supply 

Print Prints the document with the current 

setting— either high quality or rough draft 

Print As Prints the document as you specify— either 
high quality or rough-draft 

Quit Gets oat of the Notepad tool 

Another option of the Notepad is F<Ut. Under the Edit Menu Bar are 
these options: 



Undo 


Undoes your last operation 


Cut 


Cuts out a block of text from the document 


Copy 


Copies a block of text from the document 


Paste 


Puts the block of text at the current cursor 




location 


Erase 


Erases the block of text 



From the Notepad's Font Menu Bar, you can select a number of fonts 
and point sizes. The Amiga software designers chose to name the 
fonts after precious gems, including Topaz, Ruby, Diamond, Opal, 
Emerald, Garnet, and Sapphire. All these fonts are at your dis- 
posal—most of them with different sizes too. 

From the Notepad's Style Menu Bar, you can change the style of the 
text you are typing by choosing Plain, Italic, Bold, or Underline. You 
can select any combination of these last three options. Instead of 
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using the mouse, you can change the style of the text by pressing 
the Amiga key along with the P, I, B, or U keys. 

The last option on the Notepad tool is Format, You can use selections 
from the Format Menu Bar to change the color of the pen or "paper" 
on the screen. 

■ 

The Preferences Tool 

Changing the time on the clock, along with altering - briery of other 
characteristics of the Amiga, is accomplished with Pit^rences 
tool. Double-click Preferences. The screen will fill up wi.. ^e Pref- 
erences options, which are controlled through the mouse (set 5g 
1.8). If you want to change a setting, place the pointer over the 
mimber of the function you want to change and click the mouse. 
Clicking the mouse on the up or down arrow next to the number 
increases or decreases the setting. Another way to change charac- 
teristics esta>>:'shed by the Preferences tool is to point toward an 
arrow and more the arrow. 




- 

Under Preferences, you can control the following functions: 

•iltl'l TfftWs To change the date or time, olir-lf thf 

mouse at the number you want to change and use the up 
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and down arrows to adjust the value. The date is set in 
month/day/year format, and the time is in 24-hour 
hours:minutes format. Adjusting the time here also changes 
the time that the Clock tool displays. 

Key Repeat Delay: The Amiga has a repeating key function, 
which means that if you hold down a key, the function of 
that key will soon begin to repeat. The delay between when 
you press the key and when the function starts repeating is 
established by the Key Repeat Delay box. If you want a 
'oiiger delay, drag the arrow to the right with the mouse; if 
"ou ^nt a shorter delay, drag the arrow to the left. 

Key Rep at Speed: The speed at which the keys repeat is 
determined here. Drag the arrow right to make the keys 
repeat more quickly and drag the arrow left to make the 
keys repeat more slowly. 

Mouse Speed: You can select 1, 2, or 4 here; the larger the 
number, the less distance the pointer w.U move across the 
screen relative to how much you move the mouse. 

Double-Click Delay: When you double-click the left mouse 
button, the computer waits only a certain amount of time 
between the first and second clicks. If you tak*- too long, 
the Amiga interprets your actions as two separate clicks and 
not as a double-click. To increase the time that the Amiga 
allows between clicks, move the arrow in this rectangle 
down. To decrease the time, drag the arrow up. 

Baud Rate: Baud, which means "bits per second," refers to 
the speed of the serial port; this term is used (in this case) 
to describe how fast a computer can send information over 
a telephone line to another computer. If you have a modem 
with your Amiga, you can adjust the baud rate up or down 
by clicking the up and down arrows next to the Baud Rate 
selection on the screen. If you don't have a modem, you 
will not need to use this option of Preferences. 

Text Size: You can choose to have either 60 or 80 
characters per line displayed on the screen. If you are using 
a high-quality RGB monitor, choose 80 because the screen 
is capable of displaying 80 characters per line. If you are 
using a TV, choose 60 to make sure that the characters are 
displayed as clearly as they can be. 
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CU: This option is an acronym for Command line Interface, 
which offers you another way to manipulate files on your 
computer. Select ON if you want the CU icon to appear in 
the System drawer so you can use the CU later. This disk 
operating system for the Amiga is explored in Chapters 8 
and 9; you needn't be concerned with it now. 

Workbench Colors: You can change the Workbench's red, 
green, and blue levels by dragging the appropriate arrows 
left or iigh* The Workbench itself uses four colors, and 
these cc 1 ^ ai. displayed to the left of the words ResQt 
Colors. Click ore of these colors in order to modify the 
level of red, green, or biue that the color has, and then use 
the arrows to adjust the color to your liking. If you prefer 
different colors, this is the section of Preferences that you 
use to make the adjustments. If you decid," that you would 
rather go back to the colors you were using, select the 
Reset Colors box. 

Display Centering: In the center of the Preferences window 
is a box, and near the middle of the box is a symbol that 
resembles a corner mark With this symbol, you can change 
the position of what is being displayed. If your monitor or 
television is cropping off some of the display, you can use 
this tool to make the needed adjustment. Move the pointer 
to the symbol and hold down the left mouse button as you 
drag the screen to a better position. 

Printers: Choosing this part of the Preferences window 
brings an entirely new window onto the screen (see fig. 
1.9). With this window you can tell the computer what 
kind of printer you are using; what kind of paper you want 
to use; whether the print should be letter-quality or dot- 
matrix; what the pitch, space, left and right margins, and 
paper size are; whether you will be printing graphics; and 
what kind of printer port you are using. 

Edit Pointer: If you want to change the appearance of your 
pointer, you can select this option and create your own 
pointer. The Amiga will show you how to create a new 
pointer by using the mouse and any of the four available 
colors. 

When you are satisfied with the choices you have made in Prefer- 
ences, you can select Save to put those choices on the disk. IT your 
choices are temporary, choose Use; the computer will use your 
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Fig. 1.9. The printer-selection 
window. 




choices until it is turned off, at which time the Amiga will "re- 
member" only the most recent preferences stored on the disk drive. 
If you decide that you want everything set back the way it was when 
you bough: your Amiga, choose Reset All. If you want to save to the 
disk the options you last specified, select Last Saved. (These options 
are located in the upper left corner of the Preferences window.) 
Finally, if you decide not to save the settings you have chosen, select 
Cancel. Any of these selections will return you to the Workbench. 
You should spend some time experimenting with the Preferences. 
You always can reset them to their original positions. 

One interesting feature you should note about working with win- 
dows and desktops is that entire screen displays may-be moved just 
as easily as windows. Right now, move the pointer up to the top of 
the screen to the words Ami gaUorkbench. Hold down the left mouse 
button and drag the screen down as far as you like. You can move 
the screen up the same way. When you have several screens in op- 
eration, you can shift them up and down in order to work with the 
one you want. Moreover, each screen has a Front Gadget and Back 
Gadget (in the upper right comer), so you can overlap screens just 
as you do windows. Finally, notice that the Amiga will also tell you 
(at the top of the screen) how many bytes of memory you have left 
to use. 
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Ready for Programming 

Now that you have set up your computer and you have experimented 
with using the Workbench desktop and its windows, you are ready 
to undertake some programming. Although you may not have all the 
languages discussed in this book, you definitely have Amiga BASIC 
because it comes with your computer. To do the programming dis- 
cussed in Chapters 6 and 7, you will have to purchase the other 
languages used. However, even if you don't have all the languages, 
you will find reading those chapters worthwhile. Throughout the 
chapters in this book, you will expire many different ways to use 
the potential of the Amiga. 



,2 

Programming in 
Amiga BASIC 



Amiga BASIC, the Amiga's version of BASIC, is one of the easiest 
languages to use with the Amiga. BASIC (the acronym for Beginner's 
All-purpose Symbolic Induction Code) always has been the most 
popular microcomputer language for beginning and intermediate 
users. Although BASIC is not the fastest language available, it is pow- 
erful and easy to learn. Amiga BASIC is essentially the BASIC language 
with some enhancements. Besides being one of the best and most 
advanced versions of BASIC available, Amiga BASIC is easy to master. 
Because the words of the language are so much like English, you 
should be writing simple programs within half an hour. This chapter 
helps you learn the Amiga BASIC language through the step-by-step 
creation of short sample programs that demonstrate what different 
keywords do. 

Two methods are available to tell the Amiga what to do when you 
are using Amiga BASIC. You can type commands frornthe keyboard 
or you can create a program. 

To use the language in either way, you first double-click the Amiga 
BASIC icon. You will see two windows: Output and List. The Output 
window displays the results of your programs. You also use the Out- 
put window to enter commands directly (for example, PRINT 
"HELLO"). The List window, on the other hand, is where you type 
or edit a program. You can open either window by moving the 
mouse pointer to that window and clicking the mouse button. 

At the top of the Amiga BASIC screen is the Menu Bar, which pro- 
vides a variety of options. You can do such tasks as suspend a pro- 
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gram, stop a program, or alter the contents of the program lines. 
The items under the Menu Bar are generally self-explanatory, and 
you can display any menu by moving the pointer to the Menu Bar 
and pressing the right mouse button. 

To edit a program, you open the list window, move the mouse 
pointer to the part of the program you want to edit, and click the 
left mouse button. You can use the cursor keys to move around, 
the BACKSPACE key to delete characters, and the other keys to add 
characters to a program line (see Chapter 3 for more information 
about editing programs). As always, input from ihe keyboard should 
be followed by pressing the RETURN key. To use a ^ xrara type 
the RUN command from the Output window. 

As mentioned, you have two ways to give instructions in Amiga BA- 
SIC. The first way is from the Output window. You type a command 
from the keyboard, which the Amiga executes immediately. For ex- 
ample, if ;ou want the Amiga to tell you what 3 times 5 is, you can 
type 

PRINT3«5 

When you press the RETURN key, the monitor immediately displays 

15 
Ok 

When you give the computer a direct command, the computer re- 
sponds immediately to that command. 

The second way to get the Amiga to respond to Amiga BASIC is by 
a program, which you create in the List window. A program is an 
ordered set of instructions for the computer. You tell the Amiga in 
what order to execute these instructions by means of numbered 
program lines. When you are typing an Amiga BASIC program, you 
give a number to each line of instructions. These numbers tell the 
computer the order in which you want those instructions to be 
executed. The numbers you use or the order you type them doesn't 
matter because the Amiga puts the lines in correct numerical order 
for you. 

Creating Programs 

To gain an understanding of programming, you should create all the 
programs given as examples througnout IMS DOOIL mis will malce 
the learning process easier and more fun. Don't be concerned if you 
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don't know what all the statements do yet; you will learn all about 
them in this chapter and the next. 

Enter the short program that follows. Because Amiga BASIC treats 
uppercase and lowercase letters the same, you do not need tc be 
concerned about them as you type the lines. Every time you get to 
the end of a line of commands, press the RETURN key to tell the 
Amiga that you have finished entering that line. Be sure to type the 
lines exactly as shown here. 

10 LET A = 5 » 3 

5RJ1THIS IS A UERY SIMPLE PROGRAM 

4k? iT^NT "THE VALUE OF A IS " ; A; "AND THE UALUE OF B 

IS "B". MUCH FOR ADVANCED MATHEMATICS. " 

20LETB = Z + 5 

50 END 

When you finish entering this little program, you can display it on 
the screen. To do so, issue the LIST command and press RETURN. 
On your screen, you will see the follovmg: 

LIST 

5 REM THIS IS A UERY SIMPLE PROGRAM 
10LETA = 5*3 
20 LET B = 2 + 5 

40 PRINT "THE VALUE OF A IS "; A; "AND THE VALUE OF B IS 
"B". SO MUCH FOR ADVANCED MATHEMATICS. " 
50 END 
Ok 

Notice that the program lines are now in numerical order but oth- 
erwise appear exactly the way you typed them. If you use the RUN 
command to start this program's execution, you will see the fol- 
lowing lines on the computer screen: _ 

RUN 

THE VALUE OF A IS 15 AND THE VALUE OF B IS 7. SO MUCH FOR 

ADVANCED MAThSIAT ICS. 

Ok 
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Line Numbers 

The following are the only rules you have to observe about line 
numbers: 

1. Make sure that the numbers are in the order you want 
the lines to be. 

2. Don't use negative numbers or numbers higher than 
65529. 

3. Don't use decimals in line numbers; for example, you 
can't have a line number 10.5433- 

When you are using line numbers, make sure that the intervals be- 
tween the numbers are large enough so that you can insert more 
program lines if yo^ want to. Begin your program with line numbers 
like 10, 20, 30, and so on, instead of 1, 2, 3- This practice will make 
it easier to add to the pro^rwn later. 

Line numbers have another purpose besides just getting a program 
in order. They are used as references for the rest of the progum. 
As the preceding short program stands, the computer will simply 
do what it is told to do in lines 5. 10, 20, 40, and 50. However, 
you can make a program "jump" to a diffeient part of itself instead 
of processing straight through to the end and quitting. 

Before you explore how a program "jumps," you need to get rid of 
the program you were working on. To clear the program from your 
screen, type NEW and press RETURN. 

Now type this next short program. Remember to type these lines 
exactly as they appear and to press the RETURN key after each line 
you enter. 

10 REM Here i s a program that uses a GOTO command 

20 PRINT "Good day. I am the Amiga personal computer. " 

30C = C+1 

40 PRINT "I haue said that"C"times already today!" 
50GOTD20 

If you make a mistake while typing, just press the BACKSPACE key 
as often as necessary to erase your mistake. If you press RETURN 
after typing a program line and the computer tells you that you have 
made a mistake, examine the line carefully to find your mistake and 
type the whole line again. You will If am an easier way to correct 
mistakes later, but for now make the correction by typing the line 
again. 
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Infinite Loops 

As you may have guessed, the GOTO 20 in line 50 tells the Amiga 
to go back to line 20. In fact, as the program runs, it will keep 
coming to line 50, which tells the program to go back to line 20. 
This is called an infinite loop because the program will keep running 
as long as the Amiga is working properly. The computer has no 
reason to stop the program. Here's what happens when you execute 
the program: 

RUN (RETURN) 
Good day. I am the . suvj personal computer. 
I haue said that 1 times alroady today! 
Good day. I am the Amiga personal computer. 
I haue said that 2 times already today! 
Good day. I am the Amiga personal computer. 
I haue said that 3 times already today! 
Good day. I am the Amiga personal computer. 
I haue said that 4 times already today! 

The computer will continue being friendly and comp.bining about 
how many times it has had to say "Good day" to everyone. This 
program uses some simple commands, which you now will explore 
one line at a line. Before you continue, however, press the CTRL 
and C keys at the same time; this action will stop the program. 
CTRL-C is used to "break" any Amiga BASIC program's execution. 

The first part of the program, line 10, is a REM statement: 

10 REM Here is a program that uses a GOTO command 

REM is a short way of saying REMARK You use REM to make a note 
or remark to yourself in the program. The computer ignores anything 
following the word REM in that program line. You even can type 

10 Remarkable program, isn' t it? Thank you uery much. 

The computer will ignore this entire line because it begins with the 
three letters Rem. However, you must follow REM with a blank space 
so that the computer can recognize REM as a separate keyword. Use 
REM to make notes to yourself in the program so that you can better 
understand what certain parts of the program do. This practice also 
will help you find programming errors easily. 
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The PRINT Command 

Line 20 contains the PRINT command followed by the words that 
tlie program prints out: 

20 PRINT "Good day. I am the Amiga personal computer. " 

The PRINT command prints on the screen (displays) whatever 
comes aftf:r the command. Here are some sample PRINT statements 
anc u.e —suiting output: 

PRINT '-til ' T 
HELLO 

PRINT "The sum of 2+2 is"; 2+2 
The sum of 2+2 is 4 

PRINT 10 

10 

PRINT5 + 7 
12 

PRINT 5 * 1000 "is a pretty big number. " 
5000 is a pretty big number. 

You should notice three characteristics of PRINT: 

1. PRINT can display both words and numbers. 

2. PRINT displays whatever is enclosed in double 
quotation marks (") exactly as the material is entered. 

3. If numbers are outside the quotation marks, PRINT 
displays the mathematical result. 

You have to be careful with quotation marks because the computer 
doesn't have different symbols for opening and closing quotation 
marks. The rule is that the first quotation mark means open, the 
second quotation mark means close, the third quotation mark means 
open, the fourth quotation mark means close, and so on. What is 
not enclosed between opening and closing quotation marks is out- 
side the quotation marks and therefore is regarded as a mathematical 
statement of some sort (which can include variables). 

You also should keep in mind that you can use a semicolon (.;) at 
the end of a PRINT statement. Normally, the PRINT statement prints 
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each statement on a separate line. If you don't want the computer 
to skip to the next line, put a semicolon at the end of the entire 
PRINT statement. 

Using Variables 

In the Amiga BASIC language, you can assign values to variables, 
which are symbols made up of letters and numbers. As in algebra, 
you can let something represent * number, and that "something" 
can hold the value of the number c^-n if number changes. For 
instance, you can let the variable A equai J^e number 10 by typing 
the following: 

A=10 

Watch the results of the following two PRINT statements after you 
have assigned the variable A a value of 10: 

PRINT "A" 
A 

PRINT A 
10 

In the first PRINT statement, the computer did exactiy what you 
told it to do: to print the letter A. Because the letter was enclosed 
in quotation marks, it was treated as a string and was therefore 
displayed exactly as entered. (A string is simply a series of one or 
more characters.) In the second PRINT statement, you told the com- 
puter to PRINT A (without quotation marks), and the letter A was 
interpreted as a variable. The computer therefore displayed the pre- 
sent value of the variable A, which is 10. 

As mentioned earlier, the values of variables can change. Look at 
the third line of this short program: 

30 C = C + 1 

This line tells the computer to "make the variable C equal to itself 
plus 1." Every time line 30 is executed, the value of C increases by 
1. The statement makes no sense algebraically; in algebra, C always 
equals C. With computer programming, however, you can bend the 
rules. By making C equal to itself plus I, you can change the value 
of the variable. 
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The following PRINT statement combines words with a variable: 

40 PRINT "I haue said that"C"times already today!" 

The PRINT statement is followed by the words / have said that in 
quotation marks. The next part of the statement, the variable C, is 
not. enclosed in quotation marks. C is treated as a variable, and its 
value is displayed between the first set of words and the second set 
of words. The second set of words— times already today!— is 
within quotation marks an J therefore will be displayed exactly as 
it appears. 

Finally, consider the line 
50 GOTO 20 

This command sends the program directly back to 'ine 20. Get rid 
of this line by typing the line number and pressing RETURN: 

50 (RETURN) 

line 50 is gone now. Type a new line 40. By typing line 40 again, 
you erase the old line 40 and replace it with the new one. This fact 
is important to remember when programming because you don'f 
want to wipe out program lines accidentally by using the same line 
number twice. The new line is 

40 PRINT " I have said that"C"times already today ! " = GOTO 20 

When you RUN this program, you will discover that it does exactly 
the same thing as the old one. You attached to the end of line 40 
the command that used to be on line 50. Note the colon (:) sep- 
arating the original line 40 statement and the GOTO 20 statement. 
You can have many different commands on the same program line, 
as long as they are separated by colons. 

Number in Amiga BASIC 

At this point, you should take a few minutes to learn the rules for 
using numbers in Amiga BASIC. Although you can't use decimals 
(such as 0.653 and 0.1) in program lines, you certainly can use 
decimals in Amiga BASIC. You also can use negative numbers, sig- 
nified by the minus sign (-) in front of the number. One important 
restriction is not to use commas in numbers. In the English language, 
the number one thousand often is expressed as 1,000. If you typed 

A - 1,000 into the Amiga, however, you would get an error m socage 
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because commas never should be used in numbers. Instead you 
would type 

A = 1000 

When you are assigning numbers to variables, three different kinds 
of variables are available. These are the integer variable, the single- 
precision variable, and the double-precision variable. 

An integer variable, denoted by the percentage sign (%), holds any 
number from -2,147,483,647 to 2,147,483,648. This type of variable 
will not retain a decimal value; instead, an integc varfeHe rounds 
off a decimal to the next higher number. Therefore, <u integer vari- 
able that is assigned the value 16.93 would equal 17. Exampl e of 
integer variables are A%, Yl%, RR%, JW%, YCH%, and BC%. 

\ single-precision variable, denoted by an exclamation point (!), is 
the kind of variable used if you specify otherwise. In other words, 
the default variable is single precision. Because the computer treats 
a variable as single precision anyway, you do not need to put the 
exclamation point at the end of the variable unless you want to. The 
variables A, Y, Tl, U!, WOW!, GWHIZ!, HI, and LOTZ! are all single- 
precision variables. These variables can support very large numbers 
(both positive and negative) whether they have fractional parts or 
not. 

If a number is very large, the computer uses scientific notation, 
which shows a number multiplied by a power of 10. Suppose that 
the value of a single-precision variable is 

A! =3. 2353259+10 

The exponent is e + 10. The value of this number is 3.235325 times 
10 raised to the 10th power (which is a pretty big number). Single- 
precision variables can support exponents of -38 to +38. 

For extremely large numbers, the Amiga has double-precision vari- 
ables, denoted by the pound sign (#). When used with mantissas, 
double-precision variables— such as RR#, PG#, and TTK#— can sup- 
port numbers from 10 308 to 10 +307 . One way you can tell when you 
are dealing with a number so large that the computer denotes the 
number as double precision is that the exponent has a d in it. There- 
fore, mantissas such as d + 1 5 and d + 07 are used instead of e + 
10, as in single-precision variables. 
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Math in Amiga BASIC 

You can perform math operations with variables and numbers com- 
bined in any way you want. The only requirement is that you have 
an operator (such as a plus sign or a multiplication symbol) between 
the variables and numbers. Table 2.1 shows the different types of 
operators that Amiga BASIC supports. 



Table 2.1 

Mathematical Operators in Auf m b* 



Operator 



Operation 
Addition 

Subtraction 



Multiplication 



Division 



Exponentiation 



Results 

Adds elements (examples: 
PRINT 5 + 7 results in 12; A = 5: 
PRINT A + A results in 1 0) 

Subtracts the latter expression 
from the former (examples: B - 
7-20 results in the variable B 
bei ig equal to -13; NN = 20: 
PRINT 10 + 20 - NN results in a 
value of 10) 

Multiplies the first number by 
the second (examples: PRINT 
50 * 10 results in 500; H1 = 23 « 
2: PRINT H1 * 3 results in 138) 

Divides the latter number into 
the former (examples: PRINT 
50/5 results in 10; GJ% = 35: 
PRINT 105/GJ% results in 3) 

Raises the first number to the 
power of the second (examples: 
PRINT 2 A 8 results in 256; E = 7: 
PRINT 10 A E results in 
10,000,000) 



A simple example of how these operators are used in a program 
follows. Remember to type NEW before you start entering a new 
program and to press KhTUKN after eacn program une. 



PROGRAMMING IN AMIGA BASIC 



39 



10 CLS 

20 PRINT "Math Machine, brought to you by the Amiga personal 
computer" 

30 PRINT; INPUT "Enter the first value= " ; FU 

40 INPUT "Enter the second value = "; SU 

50 PRINT FU; " plus " ; SU ; " eguals " ; FU + SU 

60 PRINT FU ; "minus"; SU ; " eguals"; FV - SU 

70 PRINT FU; "times"; SU ; "eguals"; FU*SU 

80 PRINT FU; "divided by"; SU ; "eguals"; FU/SU 

90 PRINT FU; " to the power of " ; SU, " eguals " ; FU^SU 

* 00 GOTO 30 

Now enter the RUN command to start this program so that you can 
see how it works. After you have entered a few numbers and un- 
derstand how die program is operating, press Ctrl-C to stop the 
program and to get bac< into Amiga BASIC. 

Advanced Math Functions 

Amiga BASIC has many math *unctions that you can use directly or 
in a program. For example, you can use the SQR function to de- 
termine the square root of a number. To use the SQR function, type 
SQR, followed in parentheses by the number for which you want 
the square root. The following example finds the square root of 16. 

PRINT SQRU6) (RETURN) 
4 

Ok 

When you use a division function, you often have a remainder that 
you would like expressed as an integer. For instance, when you 
divide 10 by 3, the solution is 3 with a remainder of 1. When you 
type PRINT 10/3, however, the result is 3-33333. If you are working 
with integers, you can determine the remainder by using the MOD 
function. The MOD function gives the remainder of two numbers 
that are to be divided. Here is an example: 

54 MODS 

4 

Ok 

Because 54 divided by 5 is 10 with a remainder of 4 (using integers 
only, remember), the MOD function returns a value of 4. 
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Ef you have a number that lias a decimal ponic. -.. yen waat to remove 
(for iimsnce, if you want 5.25>89342 to be f ,aply 5), you can use 
the INT function followed, by she number c : vosad ia pansn&»«& 
INT rounds off to the next lower integer, so even 5.99999 feeeomcs 
5. Examples of (he INT funrtion follow. 

PRINT iHT(6S. 235732) 

65 

Ok 

PRINT INT(TS) 

75 

Ok 

PRINT INK -123. 43242) 
-124 

G ! - 

If you have a negative number that you want changed into a positive 
number, you can use the AES function. Making a number positive 
j? known in mathematics as the absolute value, from which the ABS 
comro?nd is derived. Keep in mind that a zero or a positive number 
is unaffectcr hy *he ASS function. Examples of the ABS function 
fallow. 

ft = ftB3£-230) • B - fiB5(0) '■ C = AS3(3S) 
Ok 

PRINT a B, L 
230 0 50 

Ok 

You can use the SGN function to find, out whether a number is 
positive or negative. If the number in parentheses following SGN is 
negative, the computer displays a -1; if me number is zero, the com- 
puter displays a 0; if the number is positive, the computer displays 
a 1. The following examples illustrate. 

PRINT SGN< -50) 
-1 

PRINT SGN(0) 

& 

PRINT SDH(50£3. 23423) 
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2 advanced saatteasEical func- 
sd imctioss can be Invaluable 
I aaaiifa or graphics programs. 
.5 sac feed and explained in 

re -followed fay the: number or 
wm&k: variable is tased with tSic fosdioa, and '«he num- 
ber cr variable nmsu be tiDicIosed /*s paLen*Iie§t;s. 



i E • K &8& : ^ Functions 

Function HomltB 



ATN 


(Murnsth? rrctang.eri< anh is the angle (in 
;■> i ' : s tangervi is the number you 


COS 






SIN 




a number 


TAN 


RAfrfti ti.'., * 


»» tber 


LOG 


1*1: *'•! 'f ; ftta flfife. 


riihm of s number 


EXP 


Rtise'L i f i;i vr.fuc 
you g:''c Si© c©; 


'IBIS'S 33} by the number 
• -•>q prints the result 



You can use ibe firar cronfc of previous simple math program 
to pat some of uhe ®$mz&m& iMictioac to use: 

SSSffUWF "Math rWiiiie I l s braua ht toyrai by the £0 pa personal 

UftflRINT: ] NPIJT "Bit : t> i hn ivmbgr yeu want to work mlth ■ "; FV 
40IWNT'Ttanr.turof Icgerithhof ") FU ; "is"; UIHFV) 
t» PRINT "Ths slm of " ; fv ; " is 81M (FV) 
6iFKlWT"Tteijt.fSr^Qi "j RJ ; 11 is " ; cos (FV) 
70FRIWT "tlm tanpert cri "j FV. " is "j TAK (FV) 
B0 PRINT "Th« er efr - : art of t; ; FVj " i s Am (FU) 
9§ FRIMT "The us ' raised t the power of FV ; " 
eguais " ; D<P (FV) 
100 GOTO 30 



/Jth.GU£b you tmf WZ rst seme c> 
lions in your pio."/:. i, t'.^s *dis 
to fee peisoj.-. (ferdo|. 
Hie Kr;—::ccd r-:: *'. ... £#<Qs3 feK 
table ?JL These Siar;'-:-,.^ a£i*$s - 
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Random Numbers 

G. ie function that at first might not seem to be mathe m ati c al is RND. 
This function generates a random timber between 0 and 1 (which 
is a long decimal). You must follow the function with sfsy positive 
number i in parentheses. Consider the following samples of the func- 
tion and their results. 

PRINT fMKi0) 
"ft 3223243 

PRINT RNDC5) 

H. 9873829 

PRK> SM5C1) 
. 56T392& 

No computer cari generate a truly random number because the se- 
quence that picks a i% 'Tiber is predictable; the sequence itself is a 
mathematical function. Suppose that you turned on the Amiga and 
printed the first five numbers RND generated; if you turned on the 
computer a week la>. r and did the same tiling, you would get these 
same five numbers. The computer has a certain sequence of random 
numbers, and each sequence is hrtsed on a number called the seed. 
You can change the seed given to the mathematical function that 
generates the random numbers so that the Amiga produces a new 
series of random numbers. To reseed the random number generator, 
use a negative number after RND. 

PRINT RMK-58) 
.4620339 

If you want to Snd out what, the last random number generated was, 
use a zero in the parentheses. 

Although RND may seem to be a use'ess function at this point, you 
^ili discover many uses throughout this book. For example, RND 
is an excellent way to produce random graphics and sounds. More- 
over, many programs, such as video games, use random numbers; 
for example, in certain outer space video games, the END function 
is used to make a random number of aliens appear on the screen. 

Because the result of die RND statement is a fairly messy decimal 
number, you may want die result expressed as an integer, which is 

easier to xvnrlr with. The. solution to this r^-obJem is to USC the. 
following formula: 
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VAMABZMk the te yoi >77&st the oadast aumber to be 

put into, aad .' M it LMtesi passible mmjber you want 
generated WifJa &!i :. . . ... ?jftgf £ random number is attained, the 

Ea£kber is mrdrip;i'ed by cLe 1 %fieat nurobcr yeu tM generated. 
Next, the decimal par of the masfter is removed, snd (Ms number 
is increased by & value of 1. TLii : ssults to a number between 1 
and the high iisoit you have selected. Suppose that yew want to gen- 
erate a random nTsmbsx between 1 and 50, and instead of putting 
the n r *mb£<. 'mo a variable, you prefer having the result displayed 
imiDedis.i.v.^ v ou i ype 

33 
Ok 

You will be seeing a great deal of the RNb miction in Chapter 5. 

„Woridog wMi Stukig Variables 

Numbers aren't the only elements that car., be p,<: L"to variables. 
Strings, which are sets of leiters arid numbers, also can be put into 
variables a'H appropriate, sSryig variables. To demote a btrng 
variable, you put a do'. T ^ s%a (?) after the variable name. Here are 
some sample string variables: 

AS = "He 1 J □ there. I m the &aif£ computer from Comsodore- 
&niga. " 

Big = "The eusrtsdy report shows & 72/. Increase in sales!" 

li2F^US="TU!sisf. test" 

The computer will put inside the variable exactly what is inside the 
quotation marks, bnt will not include the quotation marks them- 
selves Li the string. Notice tfi at you can put nyixibers, fext, symbols, 
and almost anything else you want inside a string. The only thing 
you don't, want inside a string is the double quotation mark because 
that will make the compute* "shiok" that you are at the end of a 
string, 



'bitted* Sti it T>g$ 

A\hou£h string canact be inuStipIied, added, subtracted, or rub- 
paed to o&cr mgfefanastfc** factions, you can use the plus si^n 
lo put saiegs togette. Dsy t&is on your computer: 

Bi& = "i * ■ "*1 k^od "«n ^° cn '- a to tne iid oi * thsir countr i'- " 
fRIWTfiS + Bl* 

Kuw is the tl«e for al 1 good men to coma to tba si d of their 
sounlry. 

ECS = AS*Bi$= PRINT GC$ 

How is the time for all feood man to corns to the aid oT uheir 

COUftV?. 

Ok 

Notice that you made up a new string, CCS, by "adding" A$ zz<*< BU. 
If you ted made CC$ equal to Bl* + M, the new string variable CCS 
would have been for all aoorf r.ien to come to the sid of their 
countryNoif is the tiae . 

String Functions 

Like numeric variables, string variables are supported by many func- 
tions in BASIC. The first of tee, LEW, tells you the length 
in chsactm of a string. Hie length includes all spaces, punctuation 
symbols, letters, numbers, and anything else in the string, as in the 
folowing example. 

Y$ = "The longest siring in the west ! " 

PRIKf UBNCYtt 

Si 

Ok 

- 

VQbm a string bep'ns with a number (or consists etitire?/ of s :■• m- 
ber),yotf can axtsv-ct Ms number End dlipJsyit orput it into 8 nothef 
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v^-'. T e. Tb* "ction yoe use to da ifife, V/vL, Ctf • : r fte first 
jjodJoa c. iu\ i teg Sat t sr^jber. $T¥AL ILidr; g Lrarnbe;. be" ~e 
iu^ffiftag eke a tlw \&&B8$b$ of &3 eft* ft die f^b <••'•' ^ 1 » 
Ifjgt Dumber Cf.&Jia.U'ffT 'Jie tg leosafes btCssct). If ss D.ur: ' zs is not 
th fkst p?r% of & 2 sfieiag or tir«e *r/b.c string, VAL recm :: a value 
of zfiia 'Ike fc2 .ifi® esfi$Ss$ toKSTOtte tie im of " X 

fm^UfU^ws eUif^rtfi^ sir") 
Ok 

RRIKT V.*L ("Sc? yotf re 21 then, treyeyi . 

0 

Ok 

The ogjpod&c of VAX is STV b The S'EFJ fiuiction converts a number 

into art ASCII strfeg. Trie foEowis*g couple filestores. 

iVtnt Mr 

Dk 

When you wat to print a single cbaraccer many times, you w?ii fad 
the STi'SINGf Sanction fodpfuL STEMGS creates a sfrfc?g that consists 
of ?, spec ? fbd miffibef of repetitions of the same character. STRINGS 
should be followed by two dements in parentheses and separated 
by a comma. "Tie i eteost is a number that lefts the computer 
how many of the eli&iSKSefS you w and tire second is the char- 
acter itself. 

raeamn€OT4 "ft"-) 

Ok 
Ok 

PR!NrLQKg*IJON& 
Gk 
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For tlie reooorf element, instead of using a character in quotation 
raasfes, ycti can use the ASCII value of the character you want to 
print For example; 

fW»w^.mY»tW.to ... 

Ok 

Amiga BASIC has a function, SPACES, devoted exclusively to dis- 
playing spaces. This functkr woiJss just like STRINGS, except diat 
you don't have to specify tL; -hai«„ n - you are going to use because 
the Amiga already knows that ^hifictet will be a space. You 
simply specify the number of repetition U. parentheses after the 
command The following example uses SPACES to indent the line 
10 spaces: 

PRINT SPi^CEf( 10); "V m over here" 
I' mower here 

Notice that the semicolon in the PRINT statement tells the computer 
to display V rt oyer here directly after the 10 spaces. When you are 
using a PRINT statement, the semicolon works just like the addition 
sign for putting strings together. PRINT with a semicolon tells the 
' •>.^?uter, Totft skip to the next line; Just go ahead and keep print* 
ir?g on this line." 

When you are working with a string, you sometimes may Want to 
work with only a piece of that string. For instance, suppose that you 
have a string that contains the city, state, and ZIP code of a person's 
address (ADDR* = "New York, NY 10020"), and you want only the 
ZIP code. You need to extract the last five characters of the string. 
You can. accomplish this task with the RIGHT* function. RIGHT* 
should be followed by two elements separated by a comma within 
parcii&eses: the name of the string you are working with and die 
number of characters you want to exfcact. Using the ADDR* ex- 
ample, you type 

ZiPCCnJE* = RIGHT$(ftnTRS, 5) 

The ZIP code is now stored in a string called ZIPCOBF*. Keep In 
mind that die original string remains exactly as it was unless you 
alter it directly. 

Amiga BASIC dso has a LEFT* command, which gets the leftmost 
characters out of a string. Here's an example: 

0k 
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El fifty 

e& - 

J° a fet is to (fe m&fcOe Of £ Sfcia* "JSC the WSTR 

fraction. Tiie fcrmst of ffc?.: foactioa Is " "* 

INSI^csriqg, begsaaZcg etasctee, length) 

^ * &£ n TJiie cf &e scril ^ te&rvteg cbantcter is the ou ~ 
of she c^r scter you waiir. fo start Willi (for example, 5 v—ldr, 
X* want the ^string to begin with • he fifth chapter L 4 
yoo are ^ with). the number of characters you . 4 

e^ed fcosn the string Some esampfc* of the INSTO faction 

fiS- "SoB&'*en In the middle of this sentonea" 
Ok 



print mmcz, n\ & 

(nlddla 

Ok 

PRINT INSIRtte, 5, 5) 

whore 

Ok 



Using die ASCII Character Set 

•The Amiga computer, like all personal computers, uses the /?cn 
character set ASCII, which is , system cf r^enZ coLmS 

«* computet- to another. R>r example: the her 
for the cspifc ! letter A is 6$ on the Amiga. ACT cotfc 6? a£ 
tesents A « Macintosh, IBM PC, 5mm,odorT«. ^ 

mimuera with the corrapondtag characters. 

Ute you «fe« ASCD number corresponds to the first characte vou 
give the C0B-r,»tter, for example, ^ 
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This statement causes the computer to display the number 65. 
likewise, typing PRINT ASCC Adam's Apple") results in 65 because 
the first character of the siing is the capital letter A. 

The opposite function cfASC is CHRI, which accepts an ASCII num- 
ber in parentheses and displays the ASCII character equivalent, as 
in the following example: 
PRINT CHR$<65) ; CHRSC66); CrF$(67) 

ABC 
Ok 



Creating Subroutines 

You -tlready have discovered how to create a subroutine using the 
GOTO command, which makes the computer jump to a specified 
line in the pi >gram. You can create an infinite loop by making the 
program continue to GOTO another line without end; in this case, 
you can break out of the program by pressing CTRL-C. 

You can create a different type of subroutine with the GOSUB com- 
mand. GOSUB aisc mskes the computer jump to a certain part in 
the program; but wherever a RETURN command is issued, pro- 
cessing returns to the program line immediately following the GO- 
SUB command. 

10 RBI This is a sample program demonstrating GOSUB 
20 PRINT "I am the Amiga Computer. " 
30 PRINT "Excuse me for a moment. " 
40 GOSUB 60 

50 PRINT "Thank you. "= END 

60 PRINT "I just wanted to make a subroutine here. " 

70 RETURN 

Ok 

RUN 

i am the Amiga Computer. 

Excuse me for a moment. 

I iust wanted to make a subroutine here. 

Thank you. 

Ok 

HI LillS program, tiic euiupuicr encounters the GOSUB statement in 
line 40, and processing jumps to a subroutine at line 60. When the 
RETURN is encountered in line 70, the Amiga returns to the point 
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just after the GOSUB statement, in this case, line 50. The END state- 
ment on line 50 stops the program so that it doesn't execute lines 
60 and 70 again. Ano.her reason that the END statement is on line 
50 is to ensure that the computer doesn't try to do another RETURN; 
that would cause an error because the GOSUB already has been 
executed and the computer wouldn't know where to RETURN to. 

Counting with Your Computer 

^e loop is an important concept in programming with Amiga BA- 
SIC, with die loop commands, you can count in steps other than 
1. Also, you can use a loop to get the program to repeat commands 
a certain number of times. 

You can count in steps other than 1 by using the FOR and NEXT 
commands. For example, if you want to count from 1 to 21 in steps 
of 5, you could program the computer to count 1, 6, 11, 16, 21. 
The FOR... NEXT commands tell the compu, tr that you want to count 
from one number to another number with a certain step, or 
increment 

What's more important is that not only can you count with 
FOR... NEXT, but you also can get commands to repeat a certain 
number of times by embedding those commands in the FOR and 
NEXT commands. For example, if yoi> want to count from 1 to 10 
and watch the computer count, you can RUN this simple program: 

10 FOR I = 1 TO 10 
20 PRINT I 
30 NEXT 

Line 10 tells the computer to count from 1 to 10 and to use the 
variable I for the counting. The PRINT statement online 20 prints 
the current value of I, and line 30 completes the loop by telling the 
Amiga to "count to the NEXT number." This loop makes the com- 
puter go to lines 10, 20, 30, then back to lines 10, 20, 30, and so 
on, until the loop is finished. The output is 

1 
2 
3 

5 
7 



> . v 

\ 
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- . . < 

Ok 

You can make the FOR.. NEXT loop more useful by substituting a 
new line 20: 

20 PRINT "The sguare of "; I; "is"; 1*1 

The revised program prints the square of each number. 

The square of 1 is 1 
Tus» sguare of 2 is 4 
.."it rouare of 3 is 9 
The sguare of 4 is 16 
The sguare of 5 Is 25 
The sguare of 6 is bo 
The sguare of 7 is 49 
The sguare of 8 is 64 
The sguare of 9 is 81 
The sguare of 10 is 100 

You can change the increment Mth which the computer counts by 
following the FOR statement with STEP and the increment you want 
the program to use. For example, if you wvr the computer to count 
from 1 to 100 in steps of 3, you type FOR A = 1 TO 100 STEP 3- 
This statement makes the program keep looping until it reaches the 
value of 100, at which point processing goes on to whatever follows 
the loop. 

To count backward, you can make the step negative. Table 2.3 shows 
a few sample FOR.. NEXT statements and explains what each one 



Nesting Loops 

You have seen how a loop keeps repeating until completed. Now 
you will see how you can "nest" one loop inside another. Take a 
look at this example: 

i0FORA=lTO3 
20FORB = 1TO3 

30 PRINT "A IS"; A; "AND BIS"; B 
40 h£XT 
50 NEXT 
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Table 2.3 
FOR.. .NEXT Statements 



Statement 

FORI = 1 TO 10: NEXT 

FOR B1 = 50 TO 1 STEP -1: NEXT 

FOR HH = 700 TO 9000 
STEP 20: NEXT 

FOR J2Z = 10000 fC 1OU00 
STEP -1000: NEXT 



Action 

Counts from 1 to 10 

Counts backward from 50 
to1 

Counts from 700 to 9,000 
in steps of 20 

Counts backward from 
10,000 to -10,000 in steps 
of -1,000 



The loop using the B variable is nested inside the loop using the A 
variable. The program first encounters the A loop and makes A «. ual 
L Then the program encounters the B loop and makes B equal 1 
When the program finds the first NEXT statement on line ?0 the 
program goes back to the most recent FOR statement, which ;->' this 
case is the statement using the B variable on line 20. After the oro- 

T 3 B thC Pr °^ ^ down 

to the NEXT on fine 50 and goes back to the most recent FOR 

statement that hasn't been used yet, which is, in this case the one 
using the A variable on line 10. The A variable now equals 2 and 
he program encounters the B loop once again and counts from 1 
to 3 with B. The output looks like this: 

AIS1ANDBIS1 
A IS 1 ANDB IS2 
A IS 1 AND B IS 3 
A IS2ANDB IS 1 
A IS2ANDB IS2 
A IS 2 AND B IS3 
A IS3ANDB IS1 
A IS 3 AND B IS 2 
A IS 3 AND B IS 3 

When the A variable finally reaches a value of 3, the program jumps 
out of that loop, and the program is over. You can nest as mariy 
loops as you like, as long as you have corresponding NEXT and FOR 
statements for each loop 
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One hint for writing FOR... NEXT statements: Follow the next state- 
ment with the name of the variable. This will clarify which NEXT 
corresponds with which FOR. You can modify your earlier program 
as follows: 

i8F0RA = iT03 
20 FOR B = 1 TO 3 

38 PRINT "A IS"; A; "AND BIS"; B 
40 NEXT B 
50 NEXT A 

Now you can more easn, ~ where the FOR.. NEXT loops are. You 
can take this a step farther by I ?ving one NEXT statement do all 
the work by following the NEXT with both variables: 

10 FOR A = i TO 3 
20 FOR B = 1 TO 3 

30 PRINT "A IS"; A; "AND B IS"; B 
48 NEXT B, A 

You soon will fin'l that loops are invaluable in programming. They 
can repeat a function a certain number of times and at a specified 
step, and they can move forward or backward in increments as sn>all 
or as large as you like. For instance, FOR I = 0 TO 1 STEP .0001 is 
perfectly^ acceptable. The real key to writing effective FOR... NEXT 
statements is to make the most use of the counter variable. The 
counter variable in a loop should not serve just to count. Instead, 
use the counter variable as a tool to accomplish other tasks. 

Experimenting with 
Simple Programs 

The following sample programs will help you better understand the 
concepts presented in this chapter. Type and RUN these programs 
and pay careful attention to what each line does. Practice with these 
simple programs can help you become a better programmer and 
give you the ability to create your own sophisticated programs. 

The first program computes how much a person should be paid, 
given the hourly wage and the number of hours worked. The pro- 
gram first clears the screen with the CLS command. Then the pro- 
gram asks for the name of the worker, the hourly rate, and die hours 
worked so that the amount the person should Be paiu can De Uls- 

' -- ' '" . . . ' 
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played. After this, the program repeats the process for the next 
worker. 

5CLS 

7 INPUT "Name of Worker : M ; NA$ 

10 INPUT "Hourly Rate: " ; HR 

20 INPUT "Hours Uorked = HU 

30 PRINT "Pay " ; Nft$ ; HR*HU ; "dollars." 

40 GOTO 7 

This next program accepts the starting and ending values for a 
FOR...NEXT loop and displays the squares and the . """are roots of 
all integers between those numbers. After the program ha» . eceivied 
the starting and ending values, it begins the FOR.. NEXT loop a*«J 
displays the squares and square roots. After the program is finished, 
it waits for any key to be pressed before running again 

1CLS 

5 INPUT "Enter limits: " ; S ( F 
10 FOR I = S TO F 

20 PRINT "The sguare of " ; I; "is U+*S 

30 PRINT "TSe sguare root of " ; I; "is"; SQR(I) 

40 NEXT 

50 PRINT "Press any k ey to do it again. " 
60 IF INKEY$ = "" THEN 60 fcLSE GOTO 1 

The last program takes advantage of an array variable to store random 
numbers. The array goes from X(l,l) to X(4,4), so it can hold 16 
numbers. As the numbers are being stored in the array, the program 
displays them using the LOCATE formatting command. This is a good 
example of how useful nested FOR. NEXT loops can be. 

10FORR=1TO4 
20FORC = 1TO4 
30XCR,C) = INT (RND*100) 
40 LOCATE R* 2, C»10 
50PRINTXCR,C)) ; 
60 NEXT 
70 NEXT 



Writing Your Own Programs 

You now know enough about Amiga BASIC to construct some in- 

i^r*»ct,'ng progrtuns, Yon might want to stop reading for a vvliilc in 
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order to write some of your own programs. You can refer to this 
chapter for keywords and ideas. Once you are ready to move on to 
bigger and better things, you can begin Chapter 3 and learn about 
more advanced aspects of the Amiga BASIC language. 



- 



- 
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3 

Advanced Amiga BASIC 



With Amiga BASIC, you can write programs that will make certain 
decisions. For example, these decisions might involve comparing 
two numbers, checking tc see whether a variable is larger than a 
certain number, comparing strii gs, or verifying the value of a vari- 
able. This chapter shows you how to write decision-making program 
lines, as well as shows you a number of other features of advanced 
Amiga BASIC. 



IF Statements 

Amiga BASIC'S decision-making process works like this: The program 
performs one action if the condition of the decision is true and 
another action if the condition is false. For example, consider the 
following program line: 

70 IF A = 5 THEN GOTO 50 

When line 70 is executed, a decision is made. The program first 
checks to see whether the variable A eauals 5. IF A equals 5 THEN 
processing will GOTO line 50. If this* condition is not true (for 
instance, if A equals 7), processing will "slip through" to the next 
program line. 

To use the IF... GOTO decision-making statement, you type IF fol- 
lowed by a condition; next type THEN GOTO followed by a line 
number. The line number tells the computer what line to go to if 
the condition is true. If the condition, is false, the computer takes 
the only alternative action: the program goes to the next program 



Amiga BASIC has three forms of the IF...GOTO command. They all 
accomplish the same task, so the one you use is your choice. The 
forms are 

IF...GOTO <line number> 

IF...THEN <line number> 

IF...THEN GOTO <line number> 

Witliin IF statements, you can specify conditions by using mathe- 
matical operators. Table 3.1 shows the kinds of mathematical de- 
cisions you can establish These decisions apply to n* -nenc variables 
and strings. 



Logical Operators 

In addition to martiematical operators, Amiga BASIC uses logical 
words to compare elements. With these logical words, you can com- 
pare more than wo elements at a time. The first logical word, AND, 
tests whether all of a set of conditions are true. If just one condition 
is false, the computer interprets tine result as false. Some sample 
statements usiii« AND with IF... GOTO and their results follow. 

IF 5=5 AND 7=7 AND 9=9 GOTO 100 

All conditions are true, so processing goes to line 100. 

IF 5=5 AND 7=6. 99 AND 9=9 GOTO 100 

Because 7 does not equal 6.99, processing moves to the 
next line without making a jump to line 100. 

IF A=5 AND 2=2 GOTO 50 

If the variable A equals 5, both statements are true, and 
processing goes to line 50. If A does not equal 5, 
processing goes to the next line following this conditional 
statement 

A similar command, OR, checks to see whether any of the conditions 
stated are true. Only one condition needs to be true when you use 
OR. 

IF 3=5 OR 6=7 OR 4=4 GOTO 30 

Although the first two conditions are false, the last 
condition is true. Because at lease one condition is true, 
processing goes to line 30. 
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Operator 



>= 
<= 
O 



Table 3.1 
Programming Decisions 

Operation Decision 



Equals 



Greater than 



Less than 



Greater than 
or equal to 

Less than or 
equal to 

Not equal to 



Is the first variable equal to the 
second variable? 

Is the first variable greater than 
the second variable? With 
strings, the computer checks for 
alphabetical order to see 
whether the first string should 
follow the second. For example, 
DOG is considered greater than 
CAT because DOG comes after 
CAT in alphabetical order. 
Lowercase letters are 
considered yreater than 
uppercase letters; therefore, for 
instance, the string lowercase 
would foiio the string 
UPPERCASE. 

is the first variable less inan ine 
second variable? The same rules 
regarding strings apply, except 
in reverse order. 

Is the first variable greater than 
or equal to the second? 

Is the first variable less than or 
equal to the second?- 

Are the variables not equal to 
each other? 



IF 3=3 OR 6-6 AND 4=4 GOTO 30 

All the conditions are true, so processing goes to line 30. 

IF 6=5 OR 87=23 OR A=9. 5 GOTO 30 

If A does not equal 9-5, all the conditions are false, so 
processing does not go to line 30. 
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Other logical word commands, which follow the same pattern as 
AND and OR, are XOR and EQV. When you use XOR, the computer 
takes action only if just one of the two conditions stated is true. If 
both are true or if both are false, the computer does not act on the 
statement When you use EQV, the Amiga takes action if the two 
conditions are both true or both false. Otherwise, processing goes 
to the next statement 

You can use the IF statement with more than just the GOTO state- 
ment. In fact you can follow IF and a condition with just about any 
regular Amiga BASIC command. To use IF with another command, 
type IF, the condition or conditions you want to check, followed 
by the word THEN and the action you want taken if the final result 
is positive. Consider this example: 
IF AGE < 10 THEN PS J NT "You' re pretty young. " 
If the variable AGE is less Chan 10, the computer prints the words 
You' re pretty young. 

You also can have multiple statements on an IF... THEN line: 

IF AGE < 10 THEN PRINT "You' rc oretty young. "= IF AGE < 5 
THEN PRINT "In fact, you' re uery ;<oung! " 

In this case, the program first checks to see whether the variable 
AGE is less than 10. If so, the program displays You' re pretty young, 
and proceeds to the next IF statement; if not processing goes di- 
rectly to the next statement without displaying anything. If the vari- 
able AGE is less than 5, the program displays In fact, you' re very 
young! Whether or not the first IF statement is true, processing 
proceeds to the next IF statement. These IF statements work to- 
gether properly. However, you could not write statements, for ex- 
ample, where AGE is greater than 10 and less than 5. 

The ELSE Command 

Up until now, you have seen that the program will take action if a 
condition is true and will slip through to the next program statement 
if the condition is not true. With the ELSE statement you also can 
tell the program to take one action if the condition is true and 
another action if the condition is false. Consider the following 
statement: 

IF B - 5 Pm 1 r = 63. 1 THEN PRINT "Vdluys ver i f led" ELSE 
PRINT "Values In error. Please check again. " 
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The preceding statement causes the program to check to see 
whether B equals 5 and TT equals 63.4. If both conditions are met, 
the computer displays Ualues verified. However, if one or both of 
the conditions are not true, the program goes to the ELSE statement 
and displays Ualues in error. Please check again. The ELSE state- 
ment instructs the computer to take a specific action if the condition 
or conditions of the IF statement are not met. 

One command similar to the IF...THEN statement is ON...GOTO. 
With the ON . GOTO command, you can simplify a routine such as 
the one that folio ws. 

50 IF A=l THEN GOTO 1^1 
60 IF A=2 THEN GOTO 1160 

70 IF A=3 THEN GOTO 570 ELSE IF A=4 i"HEN GOTO 980 
80 IF A=5 THEN GOTO 800 

This program is rather cumbersome. Using the ON...GOTO com- 
mand, however, you can give the same instructions in more compact 
form. ON...GOTO says, "If the variable stated equals 1, go to the arst 
line number; if the variable equals 2, go to the second line number 
if the variable equals 3, go to the third line number," and so on' 
With ON...GOTO, you can condense the preceding four lines into 
one simple statement: 

ON A GOTO 1000, 1160, 570, 980, 800 

The program checks the variable A to see whether it has a value of 
I, 2, 3, 4, or 5; and processing goes to the line number that cor- 
responds to the value of A IF A is less than 1 or greater than 5, the 
program slips through to the next line. The power of ON... GO TO 
lies in the feet that you can list as many line numbers as you want 
The more line numbers you use, the more helpful ON...GOTO is. 

The command ON...GOSUB works exactly the same way as 
ON...GOTO, except that with ON...GOSIJB, processing goes to the 
subroutine at the line number listed. When a RETURN is encoun- 
tered in the subroutine, processing moves back to the statement 
immediately following the ON...GOSUB command. 

The ON ERROR GOTO Command 

Another command that takes action based on a certain condition is 
the ON ERROR GOTO command. This command should be placed 
at the beginning of a program if you want professing to go to a 



specified line number when an error is encountered For instance, 
consider the following line: 

ON ERROR GOTO 500 

This command tells the program to go to line 500 when an error 
is encountered instead of displaying an error message. Here is an 
example of how ON ERROR GOTO can be used in a program: 

10 ON ERROR K3T0 50 

20 1NPLT "Uhat number do you uant to find the square root 

■ 

Of"; Nh 

30 PRINT "in*, -uart root of '; NM ; "is"; SQR (NM) 
40 GOTO 20 

50 IF NM< 0 THEN PRINT "There is no such thing as a sguare 

root of a negative number. " 

60RESUr€20 

line 10 tells the program to go to line 50 if an error is found. In 
line 20, the program gets the number for which the user wants the 
square root. Line 30 displays the square root of the number. If all 
is weli, the program executes the instructions in line 40 and returns 
to line 20. However, if an error is encountered, processing moves 
to line 50 to display a special error message. (The most common 
error is the entry of a negative number, which cannot have a square 
root.) The RESUTE20 in line 60 tells the computer, "I've taken care 
of the error— now pick up where you left off at line 20 when the 
error was encountered" 

Screen Input 

A number of commands in Amiga BASIC are devoted to getting in- 
formation from the user and from the program and sending that 
information to the screen. These input and output commands, which 
are used to get and display information— are the focus of the next 
sections in this chapter. These commands are essential for letting 
a program "know" the wishes of the user and for being able to display 
information to the user. 

The fundamental input command is, naturally, INPUT. You can use 
INPUT in a variety of ways in order to get both numeric and al- 
phabetic data from the user. The simplest way to use the INPUT 

command is to follow it with the name of a variable: 

a , - ■, . •■• ■ • • * •. • ■■- ■ 1 - 

INPUTft 
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This command tells the computer to wait for the user to type a 
number and press RETURN; after the user enters a number, the 
number is stored in the variable A. When this INPUT statement is 
encountered, the program displays a flashing cursor so that the user 
can type the number and press RETURN. 

INPUT also can accept a srring variable in the same manner, but the 
string variable cannot contain commas. If the user enters a string 
when the computer expects a number, however, an error message 
is displayed; if the user enters a number when the computer expects 
a string, the Amiga does not display m error message, but simply 
stores the number as a string. 

If you want the user to enter a string variable called BBXI , you need 
to use a program line with the following statement: 
INPUT BBK$ 

INPUT also can accept more than one variable at a time Put the 
variables you want in the order you want the program to retrieve 
tnem and separate the variables with commas. For instance if you 
want the program to get a string caUed All, a number to be put in 
the variable ILQ and another number for the variable UU5, type the 
following program line: 

INPUT m, !LC, UU5 

The person using the program must enter the data in the same order 
as the INPUT statement (that is, first a string, then two numbers)- 
and the elements should be separated by commas. Suppose that the 
user input; s HELLO, 5.6, 78. As a result, All equals HELLO, ILC equals 
5.6, and UU5 equals 78. The two important requirements are that 
the elements be separated with commas and that the data be entered 
in the proper order. Otherwise, the computer displays an error mes- 
sage and asks the user to enter the data again. 

Frequently, you may want the computer to prompt the user for spe- 
cific informatioa You can do this in a program by using a PRINT 
statement followed by an INPUT statement, like this: 

10 PRINT "Please enter your name and your age "• 
20 INPUT NttlES, AGE 

tZTnf^ ^ °1 thiS is to put the prompt 

stnng (the sentence where the computer asks for the information) 
between the INPUT command and the variables to be entered You 
can shorten the preceding example to the following: 



r 



(=). The string variable stores tin- huul. u . — , — 1 

In the following program, the computer keeps displaying On and on 

until Uit h-iltr E is picoocd, at -?viii«h ti*ia* *h« A"> ! g" '^T 1 "}^ unt 1 1 



1 



i 



10 PR JNT "Or, am , „ 

30GOTO10 " JFA$= " E " SPRINT "until r * 
if the user presses th 

Retrieving Datn 

commands Th m the program bv »«t n , P fer to read the 

20 DATA 20, HELLO 

7?le Program first reads r h« 

'eads the word /QsS ™ u™*** 20 ™o the variahi^ a , 
the two DATA , !nto the variable Al <w ' C A ^ then 

elements: Al Su PPose that you revere 

10 READ A, A$ ^ 

20 DATA HELLO, 20 

computer displays an «^ 
not put the strmp Hm o raessa 8e because the n 

™g H£LLO mto the nom^v . . ^P^gmm can- 
When you use R FA n C VariabJe A. 

fT READ and DATA, you must observe the following 
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1 Separate with commas the elements following both the 
READ and DATA statements. - 

2 Make sure that the elements with your READ and 
DATA statements are in the same order as your 
vaiiables; don't mix up strings and numbers. 

3 Be sure to READ the same number of variables that are 
* available in the DATA statements. 

Here is a longer example of the READ and DATA commands: 

10 PRINT "This .HI sho* the ages and relationships of 5 people and i «f . 

20 FOR ! = i TO 6 
30 READIES, I 

40 PRINT NAME*" is ^ I "years old. 
50 NEXT 

60FORJ=1TO3 

70 READ RELATIONSHIPS 

^^S^^U-rrU-toBin-. ^ I- «ln.J-nnlf^ . 

Dave is looking more like Frisky the Dog e.ery day ! 

The results of this program are the following: 

This u.1 1 1 shou. the ages and relationships of 5 people and i dog. 

Marge is 45 years old. 

Bill is 47years old. 

Jennifer is 23 years old. 

John is 24 years old. 

Dave is 32 years old. 

Frisky the Dog is 3 years old. 

Marge is married to Bill. 

John is dating Jennifer. 

Dave is looking more like Frisky the Dog euery day! 
When the program reads a piece of data, the program "uses up" that 
£ Sot used 'again A, the progra^ contmues to read 
Ita me program uses a pointer in memory to point to the next 
e"to fafread when another READ command is encored 
I vou us^the RESTORE command to reset the pomter, when the 
nr™L^to r^d a- ne,t piece of data, the program 
read &e Lt eSment again. Here's a short sample program to den, 
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onstrate how RESTORE resets the program's interpretation of what 
piece of data is to be read next: ( 

10 READ A$ 

20 PRINT "I read A$ again. It Is- "A$ = RESTORE : GOTO 10 

30 DATA Element One 

Ok 

RUN 

I read A$ again. It ts : Element One 

I read ASaga'n. i «. - Element One 

I read A$ again. ^ *v Clement One 

Screen Output 

Now that you understand how to get information, both from within 
the program and from the user, you will examine how to send in- 
formation to the screen. You are going to take a look at output. The 
first thing you need to know about output is how to clear the screen 
of anything mat might be on it. The CIS command eliminates every- 
thing—graphics, text, and anything else— that is on the scr-en. You 
should use CLS at the beginning of every program you write because 
you want the screen to have a "fresh start" when the computer 
begins displaying information 

You already have discovered that you can use the PRINT statement 
to display variables, sentences, and numbers. To refresh your mem- 
ory, here are some sample PRINT statements and their resulting 
output: 

PRINT "This is a test" 
This is a test 

PRINT "If the uar i able A equals 5, then we' 11 see a"; A 
If the variable A equals 5, then we' 11 see a 5 

PRINT A, B, C, D, 10 
25 43 13 43 

PRINT "A, B, C, D, 10" 
A, B. C, a 10 

ITS INT 60" 20 + Q 
1203 




The PRINT statement has some peculiarities that you should know 
about. First, if you put a comma between elements that you want 
to PRINT, the elements will be separated by spaces. Notice in the 
third example that because the variables and the number 10 are 
separated by commas, they are displayed separated from one another. 

Another punctuation mark that you can use is the semicolon (;). 
When you follow whatever a PRINT statement with a semicolon, 
the computer does not move down to the next line on the screen 
after the program displays the information. The semicolon must be 
outside the quotation marks, of course, or else the character will 
l - displayed as a semicolon. Here is an illustration of this concept: 

PRINT "The guick red fox " : PRINT "jumped ouer the fence. " 
The guick red fox 
jumped ouer the fence 

PRINT "The guick red fox n ; ■ PRINT "jumped over the fence. " 
The guick red fox jumped ouer the fence. 

Notice that the semicolon in the second example makes the com- 
puter stay on the same line so ti*z\ the second half of the sentence 
is not displayed on the line below. 

If you don't feel like typing out PRINT all the time, you can use a 
question mark (?) in its place. Typing ? "Hello" has the same results 
as typing PRINT "Hello". 



Using Variations of 
the PRINT Command 

The PRINT command has two variations: LOCATE ( ) and PRINT 
USING. Each command has specialized functions. LOCATE ( ) tells 
the computer to print something in a specific place on the screen. 

The Amiga's screen is made up of columns (which go across the 
screen) and rows (which go down the screen). Column 0 is the 
extreme left side of the screen, and row 0 is the topmost horizontal 
part of the screen. Column 0, row 0, therefore, is the upper left 
corner of the computer screen. Column 1, row 0, is just to the right 
of this; and column 0, row 1, is just below. As you move to the right 
on the computer screen, the column numbers are higher; and as 

you move dcrwxi the ocrccn, the roTv nwmbsts *w« *>SgKe«- 

fig. 3.1). 
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Fig. 3.1. The LOCATE command's 
rows and columns on the screen. 




LOCATE ( ) tells the computer to print something beginning a* a 
particular column and row. For example, to print the words /// 
THERE beginning at column 5, row 3, you type 

LOCATE (5, 3) : PRINT "HI THERE" 



Formatting Numbers 

PRINT USING is a complex statement that requires a thorough ex- 
amination. Essentially, PRINT USING formats the display of numbers. 
The statement uses a format string, which is a series of characters 
enclosed in quotation marks. These special characters tell the com- 
puter how to print a number. You can use several different format 
strings to achieve different formatting results. You may want num- 
bers to be printed as dollars and cents, or you may want positive 
and negative numbers to be printed with positive and negative signs 
in front of them. PRINT USING can make your output more accurate 
and professional-looking. 

The most basic PRINT USING format string is the pound sign (#). 
This sign tells the computer to print numbers using only a certain 
number of characters. Therefore, if you use three pound signs as 
your format string to format the variable N {PRINT USING "###"; 
AO, the program allows N only three places. If N is larger than 999 
(which means diai iv requires more man three places ), the program 
puts a percent sign (%) in front of the displayed number to show 
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that it is too large. If the variable N has a decimal portion, N is 
displayed as the next lower number. Here are some numbers and 
how they would appear if they were controlled by the statement 

PRINT USING "###"; N 

100 100 

12.5 12 

49.00012312 49 

94556 %94556 

5 5 

The next - "^ai :'png, the plus sign (+), can be used with either 
a PRINT USING Oi »ust a PRINT statement. The plus sign puts the 
sign of a number in front of it. If the number is positive, it is preceded 
by a plus sign; if the number is negative, it is preceded by a negative 
sign. Here is what happens to numbers stored in the variable X after 
being displayed with the statement 

PRINT USING "+###. ##" 

21 +21.00 

-345.23 -343.23 
7 +7.00 

Similar to the plus sign format string is the negative sign (-). The 
negative sign, however, affects only negative numbers. Another dis- 
tinction is that the program puts the negative sign after the negative 
number; therefore, -34 is displayed as 34- and -56.23 as 56.23-. 

You can use the decimal point (.) with the pound signs to specify 
how many digits you want after the decimal point. If the variable 
N equals 5.468, here are some results of various PRINT USING 
statements: 

PRINT USING "##.#####"; N 
5. 46800 

The program formats the number to include five digits 
following the decimal. 

PRINT USING "###. "; N 
6. 

The program rounds off to the next higher number because 
no decimals are allowed. 

PRINT USING "#.#"; N 
5. □ 
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The program rounds off as close as possible to the original 
number. 

One format string you will use frequently when you PRINT financial 
data or large numbers is the comma (,). The comma formats num- 
bers so that a comma is inserted every third place to the left of the 
decimal point. In order to format numbers with commas, you put 
a comma before the decimal point with your pound signs. For ex- 
ample, to display numbers with up to 10 digits, use the statement 
PRINT USING "#######, . ###" 

Here are the results of this statement ^-1 with various numbers: 

76572 76,572.000 

1000000 1,000,000.000 

76.345 76.345 

98098234 1 5 %9,809,823,4 1 5.000 

If you want dollar signs to precede your numbers, type two doUar 
signs in the format string before any pound signs. Use the same 
PRINT USING statement you just used, except this time specify that 
numbers should have dollar signs displayed with them by typing the 
statement 

PRINT USING "$$#######, . ###» 

867239 J867.239.000 
1 $1,000 
•87 $.870 

You may have noticed that the numbers are not in regular right- 
justified columns because the numbers are of different lengths The 
double asterisk format string solves this problem by making the right- 
most digits of the numbers line up evenly, while the-portion to the 
left of the left digit of each number is filled with asterisks The 
computer makes sure that every number fills up five spaces by adding 
asterisks to the left side of the number until all five positions are 
filled. PRINT USING "**###.#" formats the following numbers 
shown in the left column as they appear in the right column: 
5.34 #5.34 

870.2 870.2 
187 **187 

999.3 999.3 

3¥ M M W 1 
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To sum up the different types of format strings available with PRINT 
USING, table 3.2 shows the different signs and their effects. 



Table 3.2 
Format Strings 

Function 

Allows a certain number of digits to 
hh printed, indicated by how many 
^ouptJ signs are present 

Puts a jj!us sign (+) in front of 
positive numbers 

Puts a negative sign (-) after 
negative numbers 

Specifies at what position you want 
the decimal point and how many 
digits after the decimal point should 
be allowed 

Puts a comma every third place left 
of the decimal point 

Puts a dollar sign in front of the 
number 

Formats the numbers so that they 
are right-justified 



One last formatting option is that you can make the PRINT statement 
display a variable or text a certain number of spaces to the right by 
using the TAB function. By stating PRINT TAB (number), with num- 
ber representing how many spaces to the right the computer should 
begin printing what follows the statement, you have an easy way to 
format information on the screen. For example, PRINT TAB (10) "V m 
oyer here" prints the words I'm over here beginning at the 10th 
character on a line. 



Sign Name 
# Pound sign 

+ Plus sign 

Negative sign 
Decimal point 

Comma 
$ Dollar sign 

** Asterisks 
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Advanced Features for Variables 

By now you understand enough about numeric and string Variables 
to be able to use them well. Next, you will explore two advanced 
features for variables: assignments and arrays. These added features 
in Amiga BASIC make variables more powerful and easier to use. 

- - - 

Assignments 

One of the easiest ways to assign a number or a string 10 a >-ariable 
is with the LET command. For example, you can tea lv \rnig* to 
LET A = 50, LET R$ = "COMPUTER", or LET UJ1 = 5. 678. When you k -ke 
assignments, that is, when you store a number or string in a variable, 
the word LET is optional, so you may want to leave it out. The 
preceding three assignments, therefore, could be expressed as A = 
50, Rl = "COMPUTER", and UJ1 = 5.678. 

The equal sign (=) by itself can do more than assign a number or 
string to a variable. The equal sign also can be used to put one 
variable into another. For example, suppose that Al equals AMIGA 
and B$ equal? COMPUTER, and you make the following assignment: 
A$ = B$ 

This statement makes A$ also equal COMPUTER Both A$ and Bl 
have become COMPUTER, and AMIGA is no longer in memory. You 
can make this same type of assignment with numeric variables. 

If you would rather switch the values or the strings within variables, 
you can use the SWAP command. Suppose that you have two string 
variables, X$ and Y$; and you want X$ to contain the string currently 
in Y$ and Y$ to contain the string currently in X$ (in other words, 
you want them switched). All you have to do is type- 

SUAPX$, Y$ 



Arrays 

So far, you have been dealing with simple variables: A$, YY, Bl, and 
other numeric and string variables that hold one piece of infor- 
mation. Another way to use variables is more efficient if you are 
going to be storing large amounts of data, or if you are storing data 
that is structured in a way that would make using simple variable 
names inefficient. For example, assume that you have the following 
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chart showing how many widgets three salespersons sold during the 
months of April, May, and June. 

Salesperson: Mary (1) James (2) Darren (3) 
Month: 

April (1) 47 54 23 

May (2) 62 43 72 

June (3) 30 77 51 

Both the months and the names are numbered in order to make 
reference easier and to illustrate a n< ^ r kmc r >f variable: the array. 
Suppose that you want to store all these figures in the com- 
puter's memory. Using simple variables, you cou±J devise different 
variable names to match the first letters for each month and each 
person's name. For example, Mary's sales in June could be the vari- 
able MJ, and James' sales in April could be JA. Your variables there- 
fore would be MA, MM, MJ, JA, JM, JJ, DA, DM, and DJ. This is 
obviously an inefficient way to refer to this type of information, espe- 
cially if you are working with 50 individuals over the span of 12 
months. 



A much easier way to work with information like this is to use an 
array. An array consists of a variable name followed by a certain 
number oi elements in parentheses. In the preceding example, you 
are dealing with two factors: salespersons and months. These factors 
are known as dimensions. An array used to store these values is 
called therefore a two-dimensional array. You can have one-dimen- 
sional arrays, three-dimensional arrays, eight-dimensional arrays, or 
any other kind of array as long as the Amiga has enough memory 
to store all the information. 

You call the array in the example SA (for sales), and you use numbers 
in parentheses to refer to the salesperson number and the month 
number. For example, the sales that Mary (salesperson number 1) 
had in May (month number 2) are stored in the array variable 
SA(1,2). Mary's sales in June (month 3) are stored in SA(1,3). The 
sales made by James (salesperson 2) in April (month 1) are stored 
in variable SA(2,1). As you can see from the chart that follows, the 
first number in parentheses is the number of the salesperson, and 
the second number is the number of the month. Arrays provide an 
efficient way of working with this information because you can store 
and retrieve data easily as long as you know the numbers of the 
salespersons and months. 
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Salesperson: Mary(l) James (2) Darren (3) 
Month: 

April (1) SA(1,1) SA(2,1) SA(3,1) 

May (2) SA(1,2) SA(2,2) SA(3,2> 

June (3) SA(1,3) SA(2,3) SA(3,3) 

You can assign an array variable a value just as easily as you assign 
a value to a regular variable. The following example illustrates the 
proper format. 

A(5, 5) =67. 232 

DD$(0, 0) = "THIS IS MY FIRST ELEMENT" 

One decision you should make when you set up an array is whether 
you want your first element to be 0 or 1 . Should A(0,0,0) or A( 1 , 1 , 1 ) 
be the first element in a three-dimensional array? This choice is 
simply a matter of personal preference. Once you decide, you use 
the OPTION BASE command to tell the computer what the starting 
element value should be. If you want 0 to be the starting element, 
include OPTION BASE 0 in your program; to make the number 1 
the first reference point in an array, use OPTION BASE 1. 

If you are going to use an unusually large array (one that has more 
than 3 dimensions or more than 10 elements for each dimension), 
you need to use the DIM command to allocate enough memory for 
the array. The variables A(ll), B(2,l4,0), and CC$ (15) all require 
the DIM statement because they have more than 10 elements for 
at least 1 of the dimensions. A variable such as D( 5,6,7,2,1) needs 
a DIM command because it has more than 3 dimensions. If you don't 
issue DIM for a large array, you will get a Subscript out of Rango 
error message, and the computer will stop the program. 

To use DIM, you type DIM followed by the variable name and the 
number of elements for which space should be allocated in memory. 
If you are going to have an array called XX( ), for example, which 
goes from XX(0,0) to XX(15,3), you would type 

OPTION BASE 0: DIMXX(15,3> 

This command makes 0 the first reference point in your array and 
sets aside enough memory for the array. Enough memory has been 
allocated for the XX array to be 16 elements by 3 elements; this 
dimension allows the array to hold 48 numbers. You also can issue 
the DIM command for more than one array at a time: 

DlrttoClZ), BB(3, S,3J, C15150) 
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When programming, be careful not to use the DIM statement twice 
for the same array. Something like DIM A(20): DIM A(30) causes 
an error statement because Amiga BASIC cannot set up the same 
array more than once. You can avoid this problem by erasing arrays 
that you are finished with. If you want to erase an array, use the 
ERASE command. To get rid of all the arrays in the preceding ex- 
ample, you type ■ ; a 

ERASE A$, BB, Cl$ A -c ,w O 

You do not need to use parentheses when you use the ERASE com- 
mand, and you can erase arrays in any order you ^esii c. After youi H 
have created an array, you are free to use DIM to re^ -nsion the 
array or to do other tasks. 



Program Editing 

If you have tried to write any programs up to this point, you probably 
have made a iew mistakes along the way. Prior to entering a program 
line (pressing RETURN), you can correct mistakes simply by pressing 
the BACKSPACE key to delete the error and retyping. If you already 
have entered a program line containing an error (the Amiga usually 
will indicate an error after you press the RETURN key), you either 
can retype the entire iii.e or use the built-in line editor. 

The editor, which is actually the List window, shows you the pro- 
gram so that you can go to specific parts of the program and make 
changes. The List window is simply an electronic means for modi- 
fying the program you have in memory. Just as if you were working 
with a word processor, you can change what is on the screen. You 
can add more information, delete certain characters, or get rid of 
a line or group of lines entirely. After you leave the list window 
and go back to the Output window to RUN the program, the modi- 
fied program is stored in memory and the old one has been erased. 

To get to the editor, move the mouse pointer to the List window 
and click the left mouse button. You can position the pointer any- 
where in the window; when you click the button, the cursor appears 
at the location where the mouse pointer was. 

You can edit a program in the List window in three ways: 

1. You can add to the program. When the cursor is 
pointing to the place where you want to add 
information, click the left mouse button. You can add a 



ADVANCED AMIGA BASIC 



75 



program line, a single character, or other information. 
When the cursor appears, you are ready to type your 
new information You still can use the BACKSPACE key 
to delete characters, the arrow keys to move around 
the screen, and the mouse to move to a different part 
of the program You do not need to be worried about 
mistakes because you can correct any problems in the 
list window. Once you are finished adding to your 
program, move the pointer to the Output button and 
click the left mouse button. Your new program now 
will be in memory, ready to be saved to the disk or to 
> RUN 

2. You can delete something from the program. You can 
use the mouse to move the cursor to the information 
you want to delete and then press the BACKSPACE key 
as often as needed. You also can move the pointer to 
the beginning of the information you want to delete. 
Then hold down the left mouse button while you 
move the cursor to the end of the text you want to 
delete. After you have selected this block of text 
(which the Amiga will display in inverse video) you 
can press the BACKSPACE key to get rid of *he entire 
block. 

3. You can manipulate blocks of information. A block, 
as you may have guessed, can be a group of 
consecutive program lines, several programs on one 
program line, or any other program text that is 
contiguous (is one uninterrupted block of text) When 
you have "blocked out" a portion of your program 
using the mouse as described in method 2, you can 
perform several activities with this block of text. You 
can CUT the block, which removes it from the 
program and stores it elsewhere in memory. You can 
COPY the block, which leaves it unaltered but stores it 
in memory for later use, perhaps in another program 
Or you can replace the text with anything else you 

p?^ Cn y ° U CUT ° f COPY something, you can later 
PASTE the text elsewhere in the program or in another 
program. 

To CUT, COPY, or PASTE a block of text, move the 
pointer to Edit on the Menu Dai aiid select the Option 
you want to use. If you want to replace a block of text 
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with something else, begin typing the material; 
whatever you blocked off will disappear, and the new 
text you are typing will appear in its place. 

Now that you have examined the keywords of Amiga BASIC, you 
will look at some of the features that help you polish your program. 
This material that ibllows shows you how to delete or display specific 
program lines. 

If you want to delete a single line, you type only the line number 
and press RETURN; if you want to get rid of a group of consecutive 
'ines, you type DELETE followed by the range you want to remove. 
As you can see from the examples that follow, you can use a hyphen 
(-; to indicate arrange. For instance, 100-200 means "from 100 to 
200," and -100 means "from the beginning to 100." Be careful when 
you use the DELi TE command; you can't bring back program lines 
after they have been removed. 

DELETE- 100 

Removes all lines from the beginning of the program up to 
and including line 100 

DELETE 100- 

Removes all lines from and including 1C0 ro the end of the 
program 

DELETE 50-150 

Removes all lines from 50 to 1 50, inclusive 
DELETE 70 

Removes line 70 

The LIST command uses the same parameters as DELETE, but LIST 
displays the lines instead of removing them from the program. You 
can use LIST to display the following: (1) a single line, (2) lines 
from the beginning of the program to a specified line number, (3) 
lines from a specified line number to the end of the program, (4) 
lines from one line number to another line number, and (5) the 
entire program For instance, LIST 500-760 displays lines 500 
through 760, inclusive. Typing only LIST shows the entire program. 
If you want scrolling to pause so that you can examine what is on 
the screen, press CTRL-D. To restart the scrolling, press CTRL-D 
again. 



Disk Input and Output 

This section describes the disk input and output commands With 
these commands, you can save your program to disk, load a program 
mto memory from the disk, merge two flies, change the name of a 
nle, and start running a program stored on a disk 

When you are ready to save your program to the disk, you type SAVE 
followed by the name that you want to give the program. You must 
be sure to enclose the file name in quotation nLkTsuppose Z 

SrSgTu^" 311 Amiga BASIC prograni ** y""oc£ 



SAUE "MYPROG" 



and press the RETURN key. In a few moments, the computer finishes 
«™g the program on the disk, and you can continue with other 

A good practice is to save your program frequently as you are > wk- 

or 20 Imes, whichever comes first. That way, if the computer should 
malfunction, a large portion of what you have worked Gl -a The 

over the Amiga's power cord a few minutes before you have finished 
your program, your work will be lost and cannot be recovered 
You can save a newer version of a program over an older version 
of the same program on the disk by using the REPLACE commTd 
As you are developing MYPROG, for example, you c^tellTTnt 

will save under that name whatever program is in memory. 
Another good practice is saving the same program with different 
names. This method is a good idea for future debugging of yZ 
program. You can run the earlier versions of the pj*^ 
which versions of the program first demonstrate the pf^ems. 
LOAD is the opposite of the SAVE command, but the formats of the 

m^ < nr 1SK Tr WAD f0U0Wed * the ™* - quotation 
She LnT? ' ^ " MYPROG ")- * *e file is not on £e 
disk, the computer responds with an error message. 

You can load a program without wiping out the program that i, in 
memory by using the MERGE conJand § (Note: Befof^ou use J 
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memory.) The MERGE command combines two Amiga BASIC pro- 
grams, as long as they don't have conflicting line numbers. To com- 
bine two programs, you must have one program in memory and 
then load the other one (which you will call PROGTWO) off the 
disk by typing 

MERGE "PROGTUO" 

You already know that the RUN command will execute whatever 
program is currently in memory; now you will see how you can use 
K TT N in ot^r ways. RUN followed by a file name automatically loads 
that V>ir disk and executes the program. For example, RUN 
"MYPROG" k -»ds *nd runs the program MYPROG. RUN followed 
by a line number starts the program from that line number. The 
following example illustrates: 

RUN 50 

Starts executing whatever program is currently in memory 
from line 50 

After studying the material in this chapter, you should have an un- 
derstanding of how Amiga BASIC works and how you can program 
in this language with a minimum of difficulty. With this knowledge, 
you can move on to more advanced aspects of Amiga BASIC: graphics 
and sounds. 



4 

Creating Graphics with 

Amiga BASIC 

.2, » 



This chapter focuses on one particular element of the Amiga BASIC 
language: the graphics commands. With these commands, you can 
draw a variety of shapes and colors on the screen with surprising 
ease. Graphics commands on the Amiga computer are not only easy 
to use, but are much more powerful than the graphics commands 
of other machines because the commands execute at such a fast 
rate. Furthermore, the variety of colors available (4,096) and the 
high-resolution display make the Amiga one of the best graphics 
microcomputers available for the price. 



About Pixels 

One of the basics of graphics on the Amiga is telling the computer 
where on the screen you want to draw. You do this by referring to 
pixel coordinates. A pixel is the smallest thing that you can draw 
A character, for example, is 8 pixels wide, and you can use more 
than 64,000 pixels on the Amiga The screen is 200 pixels high and 
320-640 pixels wide (depending on your monitor). 

To tell the computer which pixel you are referring to, you use a 
two-number reference system. The first number, the X coordinate, 
indicates where the pbtel is on the x-axis, which has a value of 0 
on the far left and 319 on the far right. The number following the 
comma, the Y coordinate, specifies where the pixel is on the y-axis, 
which has a value of 0 at the top and 199 at the bottom. For example.' 
the pixel in the top-left corner of the screen is pixel (0,0). The 
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pixel just to the right of (0,0) is (1,0), and the pixel below (0,0) 
is (0,1). 

As you move to the right across the screen, the X coordinate takes 
on a bigger value. You encounter pixels (2,0), (3,0), and (4,0), all 
the way up to (319,0), which is the pixel in the top right corner 
of the screen (see fig. 4.1). 
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Fig. 4.1. The coordinate system. 



When you move the cursor downward on the screen, the Y coor- 
dinate increases in value. You find pixels (0,1), (0,2), and (0,3), 
all the way to (0,199) at the bottom of the screen. Most of the 
pixels you will use will be somewhere in the middle of the 
screen-for instance, (50,50), (178,45), and (21,150). 

In this chapter, you will learn about the Amiga BASIC graphics com- 
mands by examining their functions and working with sample pro- 
grams. Before you begin reading about these commands, load Amiga 
BASIC into the computer so that you will be ready to type and run 
the programs. You will learn the commands most easily by typing 
and running them as you read through the chapter. You also will 
be able to modify and experiment with them so that you can con- 
tinue learning on your own. 

Lines and Boxes 

LINE is the most fundamental graphics command. You use this com- 
mand to draw a line between two pixels or to draw a box or a ruled 
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box. For example, to draw a line that begins at (20,23) and ends 
at (50,60), you type 

LINE (20,23) - (50,60) 

Figure 4.2 shows the result. 



(0.0) 
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(20,23) 



(50,60) 



Fig. 4,2. A line created with the 
LINE command. 
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Suppose that you want to construct a triangle made up of the points 
(10,10), (70,10), and (40,60). You type 

LINE (10, 10) - (70, 10) ■ LINE (70, 10) - (40, 60) = LINE (40, 60) - 
(10, 10) 

Notice that you need to specify (10,10) twice because the Amiga 
doesn't automatically connect all the points. With these LINE com- 
mands, you are telling the computer: "draw from ( 10,10) to (70,10) 
to (40,60) to (10,10)." When you work with this simple command, 
you need to instruct the computer to draw another line back to 
(10,10) in order to complete the triangle. 

The following program, which draws different-colored lines between 
changing points, shows LINE in action. If you put a comma and a 
number after the LINE command, the program draws the line in the 
color represented by the number. The following short program uses 
this feature. The program first clears the screen then starts the 
FOR...NEXT loop. This part of the program will keep changing the 
X value. 



10CLS 

20FORX = 0TO160STEP4 
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Next you issue a LINE command, which draws a line between these 
pixels- from (the present X value,l60) to (0,the present X value) 
to (300 minus the present X value,l60) to (300,the present X 
value) Actually, this line looks more like three lines. These unusual 
coordinates (which keep changing because the X variable keeps 
changing) achieve an interesting graphics result. 
30 LINE (X, 160) - (0, X), RND*3 : LINE (0, X) - C300-X, 160), RND * 
3= LINE (300-X, 160) - (300, Xi, 

Instead of using a constant number . specify the color, you use 
RND * 3 to generate a random color from 0 to 3- You end the 
program by finishing off the loop, then making the program return 
to line 20 in order to run again. 

40 NEXT 
50 GOTO 20 

With a changing X value, you can create a perspective drawing. A 
perspective drawing consists of a series of lines connected to a van- 
ishing point that represents "the horizon." You draw from one pixel 
(the vanishing point) to various pixels specified by the FOR... NEXT 
loot, which alters the pixels' X values. First you clear the screen 
and 'draw the line that forms the front part of your perspective 
drawing. 
10CLS 

20 LINE (20, 150) - (280, 150) 

Then you set up the FOR... NEXT loop for X. This part of the program 
makes the X variable go from 20 to 280 in steps of 20. Therefore, 
the program draws 14 lines in order to complete the perspective. 
You follow the loop with the LINE command and then a NEXT 
statement to close up the loop. 

30 FOR X = 20 TO 280 STEP 20 
40 LINE (150,50) -(X, 150) 
50 NEXT 

Just for fun, add a COLOR statement to change the color of the pen 
that draws the perspective for the next loop. Although the elements 
of any one perspective will be a uniform color, each separate per- 
spective will be a random color. 

60 COLOR RND* 3 
70 GOTO 20 
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Writing a Line Graph Program 

Although the LINE command is simple, you can use it for many useful 
and complex applications. For example, you can use LINE to create 
line and bar graphs, sophisticated pictures, and other graptiics. 

The program that follows shows you how you can use LINE to con- 
struct the simple line graph shown in figure 4.3 (see color figures 
in center of book). The program draws a grid on the screen and 
then creates a random line graph on the grid. The program men 
both the "old" coordinate, where the last point in the line gra^ 
was drawn, and the "new" coordinate, where the computer should 
draw to. You store the old coordinate value in a variable, which you 
will call OY (for old Y coordinate). By giving the variable a value 
of 40, the program begins drawing the first graph at X coordinate 
0 and Y coordinate 40. To begin, you clear the screen and tell the 
pen to draw in white, specified by the number 1. 

5OY = 40 
10CLS 
15 COLOR 1 

Now you draw the grid. You use a changing X value to draw the 
vertical lines and a changing Y value to draw the horizontal lines. 
The X value goes from 20 to 280 in steps of 10; a line is drawn 
that extends across the screen connecting all the X coordinates. 

20 FOR X = 20 TO 280 STEP 10 
30 LINE (X, 20) - (X,160) 
40 NEXT 

The Y variable goes from 20 to 160 in steps of 10. 

50 FOR Y = 20 TO 160 STEP 10 
60 LINE (20, Y) - (280, Y) 
70 NEXT 

Now that you have set up the grid, you can begin drawing the e 
graph. To distinguish the line graph from the grid, you change Lfxe 
COLOR to 2. This graph, as mentioned earlier, is random. As 
can see in lines 90 and 110, the program draws from the old 
coordinate to a new one. Y is a random, number between 20 av. 
160. The X variable goes from 20 to 280 in steps of 3- 
FOR...NEXT loop draws the line graph on the grid; each time 
FOR... NEXT loop executes, the program draws from (X.OY) if) 
(X+2,Y). 
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75 COLOR 2 

80 FOR X = 20 TO 280 STEP 3 
90Y = RND*i40 + 20 
110 LINE (X,0Y) - (X+2,Y) 
115 0Y = Y 

Notice that the present value of Y is stored in the variable OY in 
line 115. You complete the loop with a NEXT statement. After the 
loop finishes executing, the program pauses, then returns to line Id 

to draw another random graph. ' ; P 

ii . £ • or.'v* 

120 NEXT 

140 FOR D = 1 TO 1000 : NEXT = GOTO 10 



Using Variables with LINE 

ihe advantage of being able to put variables in the LINE statement 
is that you can use the same program to draw different figures. For 
instance, you can write a program that draws any cube you specify. 
You tell the program the size of the cube and where you want to 
put it. By using the LINE statement with the numbers you provide, 
the program can draw the cube. The first part of the program clears 
the screen and asks for the cube's size and coordinates. 

10 CLE 

20 INPUT "What size cube"; SZ 

30 INPUT "X and Y coordinates"; X,Y 

35CLS 

Now the program is ready to draw the cube. The front face of the 
cube is easy to draw because it is just a square made up of the 
following pixel points: 

X,Y X+SZ.Y 
X.Y+SZ X+S2,Y+S2 

To draw the other face of the cube and the lines that connect the 
two square faces, you need to do a little arithmetic. In line 40 in 
the following program lines, the program jumps to the subroutine 
in line 110, which draws a square. After returning to line 40, the 
program changes the values of X and Y in order to draw the second 
face. Then the program executes the subroutine in line 1 10 again, 
which draws the second face, and sets the X and Y values back to 
their original values. 
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40GOSUB110: X = X+SZ/3 = Y = Y+SZ/3: GOSUB110: X = X-SZ/3; Y = 
Y-SZ/3 

110 LINE (X, Y) - (X+SZ.Y) 
120 LINE (X, Y) - (X,Y+SZ) 

130 LINE (X, Y+SZ) - (X+SZ, Y+SZ) = LINE (X+SZ, Y) - (X+SZ, Y+SZ) 
140 RETURN 

To draw the lines that connect the two faces, you connect the four 
corresponding points on each square. You use the same arithmetic 
that you used to draw the squares. 

5L ". T NE (X, Y)*- (X+SZ/3, Y+SZ/3) 
60LINt u^Z, Y) - (X+SZ*4/3, Y+SZ/3) 
70 LINE (X, Y+S*;) - (X+SZ/3, Y+SZ*4/3) 
80 LINE (X+SZ, Y+SZ) - (X+SZ*4/3, Y+SZ*4/3) 

Now that the cube is finished, you can print its si2e and coordinates. 
Line 100 is included as a "safety net"; this endless loop protects the 
cube and text from accidental destruction. If, however, you want to 
interrupt the program, you press CTRL and C simultaneously. 

90 PRINT "This cube is size"; SZ ; "and is locatQdat "; X ; ", " ; Y 
100 GOTO 100 

The following program demonstrates how you keep one point the 
same for the LINE commands you are using. The program draws a 
"sunburst" by placing the graphics cursor in the middle of the screen 
and then drawing a line to another random part of the screen. The 
program keeps resetting the graphics cursor to the middle of the 
screen, so all the lines start at the same point. The result is a sunburst 
effect (see color fig. 4.4 > 

5 PALETTE 3, 1, 1, .13 

10 COLOR 3 

15CLS 

20 LINE (150, 90) - (RND*300, RND*200) 
25 GOTO 20 

The PALETTE command is discussed later in this chapter. 

All the lines in this example are orange in order to make the picture 
look like an exploding sun. If you prefer a multicolored sunburst, 
delete line 10 by pressing 10 and RETURN. Then add the following 
line: 



30 COLOR RND * 3 
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Screen Colors 



Before you move on to more graphics programs, you should un- 
derstand how to set the foreground and background colors. The 
COLOR command determines these colors, and it can be followed 
by the numbers for the foreground and background colors, For 

instance, , eiar 5,-:: '4 

COLOR 1, 2 ' hom 1 ' 

iff ■ \.' ' !-.. :•• ' , It: < i.' • 

would set the foreground color to 1 (white) and the background c- 
color to 2 (black). The foreground color includes all the objects 
that you draw after you issue the COLOR command. 

You can find out the color of any individual pixel with the POINT 
command. Yoc cither can print the number of the color at a location, 
for example, PRINT POINT (50,34); or you can put this number 
into a variable for later use, for instance, CO = POINT (50,34). If 
the color of the pixel at location (50,34) is Fire Engine Red, the 
number stored in the variable CO is 4. 

Basic Boxes 

The LINE command automatically draws a box when given two pixel 
coordinates followed by a comma, a color, and the letter B. The 
format for this command is 

LINE (Xl.Yl) - (X2.Y2), <color>, B 

For example, if you want to draw a box with an upper left corner 
at (20,60) and a lower right corner at (290,160) using color 3, you 
would type 

LINE (20, 60) - (290, 160), 3, B 

Here are some other examples: 

LINE (10, 10) - (20, 30), 2, B 

Draws a box with an upper left corner of (10,10) and a 
lower right corner of (20,30) 

LINE (10, 10) - (20,30), 2, BF 



I 
I 

■S 



Draws the same box as the one in the preceding example, 
except that this box is filled because you used BF (box 
niied) instead or only b 



LINE (50,60) - (113,69), 1, B 
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Draws an unfilled rectangle that extends from the 
coordinate points (50,60) to (113,69) 

You can use the LINE command in a program that alters the color 
of the rectangle being drawn. By drawing 50 boxes, all close to one 
another, you can create the illusion of a .three-dimensional object 
made up of various colors (see color fig. 4.5). You clear the screen, 
set up a loop that makes X go from 1 to 100 in steps of 2, and 
change the color accoiding to the current value of X. With each 
pass through the loop, the program draws a box. After the loop is 
finished, line 60 conu -?Hy loops back to itself in order to preserve 
the picture you have created. 

10CLS 

20 FOR X = 1 TO 100 STEP 2 

40 LINE (X, X) - (X*2, X*l. 5), RND*2+1 BF 

50 NEXT 

60 GOTO 60 



Creating Random Graphics 

RND, a command used frequently in the programs in this chapter, 
is the Amiga's random number generator. Using RND and a number, 
you can generate a random number between 0 and 1 —for example, 
.52335, .01253, and .98431. Although RND is generally used to 
create unusual effects, the command also can be used to demonstrate 
how different components of a command operate. 

You can create a program, for example, that draws random boxes 
on the screen. In the sample program, the coordinates of the boxes 
are random, and the color of each box is random as well. The use 
of RND statements in this program demonstrates how the random 
number generator works and how different numbers produce dif- 
ferent results when used with the LINE command. First, clear the 
screen and generate random numbers for two different X and Y 
coordinates. 

5CLS 

10X1= RND* 300- Yi = RND*200: X2 = RND*300: Y2 = RND*200 

Now that you have established the coordinates, you can draw the 
box 

20 LINE <Xi, Yi> (K2, V2) J RND~3, 3 
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Now you can continue the loop endlessly by making the program 
go back to line 10. 

40 GOTO 10 

Run this program and watch as the screen quickly fills up with boxes. 
By making one simple modification to this program, you can fill the 
screen with solid boxes, each of which has a random color. Enter 
this new line 20: 

201.1^ <Xi. YD - (X2, Y2), RND-3, BF 

You Co. -we y&w? knowledge of the LINE command to write a bar 
graph program Tliis program is similar in many ways to the line 
graph program that you created earlier in this chapter. To draw the 
bar graph shown in color figure 4.6, you clear die screen, set the 
COLOR to black, and make a grid by using the same technique that 
you used in the random line graph program. 

5COL0R1 
10 CLS 

20 FOR X = 20 TO 280 STEP 10 
40 LINE (X, 20) - (X.160) 
45 NEXT 

50 FOR X = 20 TO 160 STEP 10 
60 LINE (20,Y)-(280,Y> 
70 NEXT 

Now you are ready to draw the bars that make up the bar graph. 
You draw the bars with COLOR set to a random number between 
1 and 3; and you start at X coordinate 40 and end at X coordinate 
240, drawing the bars every 20 pixels. 

75 COLOR RND*3 

80 FOR X = 40 TO 240 STEP 20 

Next, create a random height for the bar. To do this, you set up a 
random value, which will be between 20 and 160, for the Y 
coordinate. 

85 YY = 20 + RND*140 

Now you can draw the bar. It will be solid and start at (X+2YY) 
and end at (X+8,160). The bar, therefore, will be six pixels wide 
and extend from the bottom of the screen all the way to the random 
Y coordinate you created in line 85. You close the loop with a NEXT 
statement. 
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90 LINE (X+2, YY) - (X+8, 160), RND*3, BF 
100 NEXT 



Determining Values 

\% v Although the mathematics used in these programs might seem con- 

fusing to you, you should understand that many of the values used 
' " in the statements here are arbitrary. For example, no sophisticated 

nj U formula was used to come up with the statement LINE (X+2,YY) 

■ (X+8, 160). The statement was wiit+en with two -considerations in 
mind: (1) that the bar should be abou.. shr. pixels wide, and (2) 
that the bars should not run into each other, iiierefore, the values 
X+2 and X+8 were used as the left and right sides of the bar. 

The next program illustrates the art of writing good statements. Tiif* 
program shows that sometimes certain values are used for a par- 
ticular reason. 

10CLS 

20 FOR S = 4 TO 66 STEP 2 

30 LINE (5+S, 5+S) - (280-S, 150-S), 1, BF 

40 NEXT 

This program draws 32 boxes. Each one is smaller than the last and 
fits inside the larger boxes (see color fig. 4.7). If the boxes were 
circles, they would be called concentric because they are all similar 
in size and shape and have the same center point. To achieve the 
effect shown in the figure, the statement LINE (5+S,5+S) - (280- 
S, 150-S), 1, fiFhad to be devised carefully so that the boxes stay 
within the confines of the screen and so that the boxes all fit inside 
one another. 

To meet these specifications, careful attention had to"be paid to the 
values in the FOR... NEXT loop. The value of S goes from 4 to 66 in 
steps of 2. Therefore, the loop "passes" a total of 32 times (4, 6, 8, 
10, 12, and so on to 66). The coordinate for the upper left corner, 
(5+S.5+S), makes the X and Y values grow larger as the loop gets 
closer to its end. The coordinate for the lower right corner, (280- 
S,l 50-S), grows smaller as the loop nears its end. Each box, therefore, 
fits inside all the others previously drawn, and all the boxes fit within 
the confines of the screen. The numbers used in line 30, derived 
after much experimentation, meet these goals. 
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The CIRCLE Command 

Another fundamental command used to create graphics in Amiga 
BASIC is CIRCLE. Its format is 

CIRCLE (X,Y), <radius>, <color>, <start>, <end>, <aspect> 

In a CIRCLE statement, the only variables that you must use are the 
(X,Y) coordinates and the radius. The color is used just like you 
used it in the LINE command. The start and end options are the 
starting and ending «oinij of the circle, ranging from -2w to 2tt. 
The aspect variable, -hiai h t number that you assign, "warps" the 
circle. For example, if <r>tci is .44, the circle appears normal. 
If the aspect is .22, the shape half as high as it is wide, so the 
result is an ellipse. An aspect of .88 produces an ellipse that is half 
as wide as it is tall. 

Running the following short program will help you better under- 
stand the aspect variable. The program draws circular shapes with 
aspects ranging from .1 to 2 in steps of .05. The first ellipse drawn 
is short and wide, whereas the last ellipse drawn is tall and thia. 
Watch carefully to observe the effects of the aspect ratio as the 
program draws each new ellipse. 

10 cls 

20FORA=.1TO2STEP.05 
30 CIRCLE (150,90), 50, A 
40 NEXT 

To see the results of different X and Y coordinates, coupled with 
random radii, run the following program: 

10 CLS 

20 X = RND * 300 
30 Y = RND * 200 
40 R = RND * 30 
50 CIRCLE (X, Y), R 
60 COLOR RND * 31 
70 GOTO 20 

From this basic program, you easily can make modifications that will 
produce a number of different effects. By changing two lines, you 
can use the aspect ratio to produce random ellipses instead of cir- 
cles. First, add a command and the letter A to the end of line 50 
so that the line looks like this: 



50 CIRCLE IX, YJ, K, fl 
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Now add the following new line to make the program create random 
aspects: , 

45 A = RND * 2 

By putting circles on top of each other, you can create a three- 
dimensional cone. The trick to doing this is to make each circle 
successively smaller and shift away from the last circle drawn. 

The next program draws not just one, but four cones, each of which 
spreads out from a different corner of the screen ' r hese cones can* 
verge on each other and create a textured sphe. 7 in tne middle, of 
the screen. 

5C0L0R1 
10CLS 

20FORY = 1TO 76 STEP 2 

30 CIRCLE (Y*2,Y), Y< CIRCLE (303-Y*2, Y), Y 

40 CIRCLE (303-Y*2, 166-Y), Y = CIRCLE (Y*2, 166-Y), Y 

50 NEXT 

60 GOTO 60 

For those cold holiday nights, here is a program that uses the CIRCLE 
command to create the winter scene shown in color figure 4.8. (The 
PAINT command is discussed later in this chapter in the section 
titled "Using PAINT To Fill Shapes.") 

5 COLOR 1 
10CLS 

30 LINE (0, 120) - (319, 120) 
40 CIRCLE (150, 115), 25 
45 PAINT (150, 115), 1 
50 PAINT (150,125), 1 
60 CIRCLE (150,65), 21 
70 CIRCLE (150,55), 16 

80 CIRCLE (145,51), 2 

81 COLOR 2- PAINT (145,51), 1 

90 CIRCLE (155,51), 2 

91 PAINT (155, 51), 1 

92 COLOR 1 

95 PAINT (150,85), 1 
100 LINE (150,55) - (160, 57) 
105LINE(150,59) - (150,55) 
110 LINE (160,57) - (150,59) 
115 COLOR 3' PAINT (151.56). 3 
120 LINE (150, 55) - (150,59) 
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123 COLOR 3 
125 PAINT (145,55), 1 
127 PAINT (150,65), 1 
130 COLOR 2 : LINE (147, 63) - (149,64) = 
LINE (149,64) -(152,64) = 
LINE (152, 64) - (154,63) 
135 COLOR 1 

140 CIRCLE (127,83), 7 
145 PAINT (127,83), 1 
150 CIRCLE (173,83), 7 
155 PAINT (173,83), 1 
160 FOR I = 1 TO 100 
170X = RND*319: Y = RND*119 
180 PIXEL (X,Y) 
185 NEXT 
200 GOTO 200 

CIRCLE, like the LINE command, works quickly, as you can see from 
running the preceding programs. Now that you have examined these 
commands, you are ready to move on to more sophisticated graphics 
functions. With the functions discussed in the rest of this chapter, 
you will be able to control the kinds of lines, patterns, and shapes 
that yov draw. 

Solid Shapes and Patterns 

When you want to draw a shape made up of several different points, 
using the LINE command isn't always the most effective way to ac- 
complish the task Several other Amiga BASIC commands make draw- 
ing complex shapes easier: AREA, AREAFILL, and PATTERN. 

Using the AREA Command 

The AREA command lets you specify the points of a polygon that 
you want to create. Although the AREA command by itself doesn't 
do anything, each pair of coordinates that you give is stored in the 
computer's memory for later use with AREAFILL, which draws the 
shape. You can type the coordinates directly after the command— for 
example, AREA (10,10): AREA (50,50): AREA (100,75). You should 
use AREA and AREAFILL to draw simple shapes. Watch this next 
simple program in action as it draws overlapping triangles of many 
different colors. 
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10CLS 

20FORU1TO3 

30X(1) = RND* 300: Yd) = RND* 180 
40 NEXT 

50 AREA (Xd), Yd) ) = AREA CX(2), Y(2) )= AREA (X(3), Y(3)) 
60 COLOR RND * 3, RND*3 : AREAFILL 
70 GOTO 20 



When AREAFILL draws a figure defined by the AREA points, the 
figure remains on the screen until you clear it. You can take ad 
vantage of this feature by using the AREA and AREAFILL commW 
to create shapes that overlap each other. The result is a three- 
dimensional object that looks somewhat like half a pyramid. 
10CLS 

20 FOR X = 0 TO 300 STEP 2 

30 AREA (0,0): AREA (300,0): AREA (X, 100): AREA (300 180) = AREA 
(0, 180) = 

AREA (X, 100) 

35 COLOR RND * 3, RND * 3= AREAFILL 
40 NEXT 

After you run this program, try modifying it to display four colored 
arrows pointing to the center of the screen; 

20 FOR X = 300 TO 0 STEP -2 

30 AREA (0, 0) : AREA (X, 100) : AREA (0, 180) = AREA (300 0) = 
AREA (300-X, 100) : AREA (300, 180) 

By changing the coordinates that make up a shape, you can use the 
AREA and AREAFILL commands to create simple animation. For in- 
stance, you can create a four-point "mirror" that has two constant 
points and two changing points. The result is a rotation effect 
10CLS 

20 FOR X = 10 TO 150 STEP 2 

3^RBUX, X) : AREA (150, 10) = AREA (160-X, 110-X) = AREA (10, 100) : 

35 COLOR RND * 3 
40 NEXT 

Now that the mirror has rotated in one direction, you can complete 
the effect by making the program loop back to line 20. This results 
in continuous smooth "animatioa" 



50FORX = 150TO 10STEP-2 

60 AREA (X, X) : AREA (150, 10) = AREA (160-X, 110-X) = AREA (10, 100) = 
AREAFILL 
65 COLOR RND * 3 
70 NEXT 
80 GOTO 20 

Although this rotation effect is interesting, it isn't true animation 
because the figure is overlapping itself. By the time the mirror has 
rotated once, an abundance of shapes is concentrated on the screen; 
You can change the program so that after it draws the figure each 
time, the program pauses, then erases the figure. resist is some- 
thing more like true animation. Add the following lines the pre- 
ceding program: 

1CLS: INPUT "Color of mirror"; CO 
5 COLOR CO, 0 
20 FOR X= 10 TO 150 STEP 3 
31F0RD=! TO 50= NEXT 

33 COLOR 0 AREA (X, X) ' AREA ( 150, 10) ■ AREA ( 160-X, 110-X) • 
AREA (10, 100)= ARE AF ILL 
35 CQLDPCO 

50 FOR X = 130 TO 10 STEP -3 
61FDRD-1T0 58- NEXT 

63 COLOR 0: AREA (X, X) = AREA (150, 10) : AREA (160-X, 110-X) « 
AREA (10,100) 
65 COLOR CO 

Using PAINT To Fill Shapes 

If you have a shape on the screen that you want to fill with a color, 
you can use the PAINT command to "flood fill" that shape. A flood 
fill starts painting at the (X,Y) pixel that you specify and continues 
painting until reaching the boundary specified. For instance, if you 
draw a circle on the screen and use the PAINT command, it paints 
inside the circle until reaching its boundaries. 

The PAINT command's format is 

PAINT (X,Y), <color>, <border color> 

The (XX) specifies the place to start painting. The color is the 
number of the color that you want used to fill an area, and the border 
color specifies what color the boundary of the area will be. 
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Keep in mind that flood fills can "leak out" just like water if the 
areas are not completely bounded. If you paint a circle or square 
in which even one pixel is missing, the paint "spills" through that 
leak In other words, PAINT keeps painting until an area that is 
completely surrounded by boundaries is filled. 

The following program draws random circles on the screen and fills 
them with random colors. When you run the program, be sure to 
notice this: When a circle begins overlapping another circle, PAINT 
does not go beyond the confines of the border surrounding the first 
circle, even if that border is partially formed by another circle that 
overlaps the one being painted 

10CLS 

20 X = RND* 300= Y = RND* 180: R = RND * 30 
30 CIRCLE (X,Y), R 
35 COLOR RND » 3 
40 PAINT (X,Y), 1 
50 GOTO 20 



Painting the Amiga Bear 

You can create a more complex drawing by taking the commands 
you have learned one step farther. The next program a?es the PAINT 
command to draw a little bear's face. The program gives the features 
the appropriate colors so that the image looks just like a teddy bear. 
To begin the program, set the color to orange and clear the screen. 

5 COLOR 3 
10CLS 

Now draw the circles that make up the bear's face, eyes, and ears. 

20 CIRCLE (150,90), 20 
30 PAINT (150, 90), 1 
40 CIRCLE (130,80), 5 
45 PAINT (129,79), 2 
50 CIRCLE (170,80), 5 
60PAINT(169,79), 2 
65 COLOR 1 

80 CIRCLE (143,85), 2 
90 PAINT (143,85), 2 
100 CIRCLE (158,85), 2 
110PAINT (158,85), 2 
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To complete the picture, add line 120, which draws a smile on the 
bear's face, and line 130, which draws a nose. 

120 LINE (145, 98) - (148, 100) = LINE (148,100) - (152, 100) = 
LINE (152, 100) - (154,98) 

130 LINE (148. 92) - (150, 90) : LINE (150, 90) - (152, 92) = 
LINE (152, 92) - (148,92) 

Writing a program that draws a picture is sometimes difficult be- 
cause you have to spend a lot of time finding the correct coordinates. 
If you spend enough time altering the coordinates so that the pic.tUie 
looks right, you will be able to expand your program to make it cEo 
other things. You will do that later in this chapter, so be sure to 
save this Bear Face program onto a diskette. 

Patterns Created with 
Binary Numbers 

Until now, you have been using solid patterns in the graphics you 
have created. You also can change these patterns so that they are 
not solid, but instead conform to the specifications that you provide. 
To understand how this is done, you first need to examine the con- 
cept of binary numbers. 

The decimal system (1, 2, 3, 4, 5, . . . 10, 11, 12) is also known as 
base 10. You can create a number system out of any base, but com- 
puters primarily use base 2 (binary) and base 16 (hexadecimal) 
numbers. The binary number system involves only two digits: 0 and 
1. Therefore, numbers take forms such as 10101010 and 1 1010111. 
Detenriining the decimal value of these numbers is not difficult be- 
cause each digit's place has a specific value. 

The rightmost place has a value of 1. As you move to the left, each 
place has a value twice as high as that of the previous place. The 
next place to the left, therefore, has a value of 2; the place after 
that, a value of 4; and so on, through 8, 16, 32, 64, and so on, 
depending on how many digits (places) the binary number has. 
Some equalities to help you understand binary numbers follow. 

00000001 = 1 The only digit set to 1 is in the place 

with a value of 1. 

00000010 = 2 The only digit set to 1 is in the place 

with a value uf 2. 
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00000011 = 3 Both the 1 and 2 places are set. 

10000000 = 128 The place with a value of 128 is 1 set. 

10000001 = 129 Add 128 plus 1 to get the value of 129. 

10000010 = 130 Add 128 plus 2 to get 130. 

10000011 = 131 Add 128 plus 2 plus 1 to get 131. 

A binary digit with eight ones and zeroes is called a byte. A byte, 
therefore, is rqual to eight binary digits, or bits. 

The PATTERN Command 

The Amiga uses two bytes to determine what line patterns look like. 
Each 1 represents a pixel that is turned on, and each 0 represents 
a pixel that is turned off. Therefore, the default setting of the two 
bytes, 11111111 and 11111111, causes the line to be soHd. If one 
of these bytes were 1 100001 1, a gap of four pixels would occur in 
each segment of the line. A very long line would be full of gaps 
because the two bytes represent only a specific length of line. If all 
the bits in these two bytes were set to 0, you would not be able 
to see any lines that were drawn, because all the pixels would be 
turned off. 

Fortunately, you don't have to translate binary numbers into decimal 
numbers when you specify patterns. Instead, you simply can put &B 
in front of the binary pattern you want the polygon's border line or 
pattern element to have, and the program will do the rest. For in- 
stance, if you want the pattern's border to be made up of short 
dashes, you type 

PATTERN &B1 1001 1001 1001 100 

PATTERN makes the program draw polygon borders in a specific 
way. The &B and series of ones and zeroes specify what pixels you 
want to turn on and off in the border. 

The second part of the PATTERN command, which works on some- 
what the same principle as the first part, establishes a specific kind 
of pattern based on binary digits. You can use PATTERN to change 
how a solid figure appears by changing the pattern created by an 
AREAFILL or PAINT command. 

The PATTERN command is followed by the number used to define 
tne Doraer of the polygon. For instance, suppose that you want to 
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10CLS 

20FORU0TO7: FIRSTC(I)=255 + F: NEXT 
30 PATTERN, FIRST* 

40AREA(10,10): AREA (300, 10): AREA (150, 150) 
50F = F + 255 

60 IF F = 65535 THEN GOTO 60 
70 GOTO 20 

Line 60 checks to see whether the value of the elements has reached 
65535, the value that indicates a solid pattern. When this value is 
reached, line 60 repeatedly loops back to itself so that the solid 
pattern remains on the screen. 

For a different effect, you can program random patterns into the 
computer. Here is a simple way to determine what numbers should 
go into the first and second bytes of a word: 

1. For the second byte, which consists of the rightmost 
eight bits of the word, you can determine which 
number to use with the binary-to-decimal translation 
method discussed earlier in the chapter. If the last 
eight bits of the word are going to be 10010010, for 
example, you can determine that the decimal 
equivalent is 146. 

2. For the first byte, which consists of the leftmost eight 
bits of the word, multiply whatever decimal result you 
get by the number 256. You do this because the left 
byte has a value 256 times greater than the right byte. 
Therefore, even a small number such as 00000001 has 
a value of 256 if the number represents the left byte. 

3- After you determine the values of both bytes, add the 
values together. The result is the value of the- entire 
word. 



4. 



If you want to take the easy way out, you simply can 
use the &B symbol to tell the computer that you want 
the element to be &B1001010010100101. 

In the following program, eight elements make up the pattern. The 
odd-numbered elements are random numbers from 0 to 255. There- 
fore, the right sides of the words are affected, whereas the left sides 
remain black. The even-numbered elements have random values be- 
tween 255 and 62025 (in multiples of 255), so the left sides of the 
words change, but the right sides stay black. An example of what 
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make the upper half of a pattern solid and the lower half blank. In 
binary, the pattern would be the following: 

1111111111111111 All 16 bits are on, making the top 

solid. 

0000000000000000 All 16 bits are off, making the 

bottom empty. 

If yo u filled an area with this pattern, the entire region would be 
made up of solid lines separated by blanks. Examining the large 16- 
hit v/ords (a word equals two bytes), you can determine that the 
hifc. - number is equal to 65535, whereas the lower number is equal 
to 0. If you wanted to put this pattern into the computer, you would 
type something like 

PAT%(0) = 65535: PAT%(1) = 0 
PATTERN, PAT% 

The two numbers stored in the PAT%( ) array establish what the 
pattern will be like. The PATTERN command is followed by a comma 
(which can be preceded by a number in order to establish what 
the border should be like) and the array in which the pattern is 
stored (PAT%( )). To use more elements in the pattern, you just 
store more numbers in the array used with PATTERN. You do not 
need to tell the computer how many elements you aic using. 

One important rule to remember is that if you use an odd number 
of elements (such as 1, 3, or 5), then the program uses the next- 
highest even number for the number of elements in the pattern. For 
example, if the ONE%( ) array had only five elements and you issued 
the command PATTERN, ONE%( ), the program still would assume 
that the pattern has six elements. However, the sixth element would 
have a value of 0. 



Programmed Patterns 

You can see the Amiga move through different patterns by writing 
a program that moves increasingly from a mostly empty pattern to 
a solid one. With every pass of the loop, the program changes the 
pattern by increasing each element's value by 255. The bits in each 
element change according to the change in the value. Type the fol- 
lowing program and run it to see the results. 
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the random patterns could produce follows. The resulting patterns 
are waves that appear to be random. 

0000000011101011 
1101011100000000 
0000000011111011 
1000110100000000 
0000000011110000 
1111100100000000 
0000000000101010 
010101 11000O00G0 

The left side of every oiiv-r word changes, whereas the right side 
of the alternate words change, ^e following program demonstrates 
how this procedure works. 

10CLS 

20 FOR I = 1 TO 7 STEP 2 = FIRSTCU) = RND*255 = NEXT 

30 FOR I = 2 TO 8 STEP 2 : FIRSTXU) = (RND-255) »255; NEXT 

40 PATTERN, FIRST* 

50 AREA (10, 10) • AREA (300, 10) = AREA (150, 150) 

An advantage of the PATTERN command is that it enables you to 
superimpose images in order to create interesting illusions. Foi ex- 
ample, you can create a four-element pattern in which every odd- 
numbered element is colored entirely on the right, and every even- 
numbered element is colored entirely on the left. 

10CLS 

20 FOR I = 0 TO 3: READ FIRSTX( I ) = NEXT 
30 DATA 255, 65280, 255, 65280 

You can program a second pattern that is the opposite of the pre- 
ceding one by adding these lines: 

40 FOR I = 0 TO 3 : READ SECONDS I ) = NEXT 
50 DATA 65280, 255, 65280, 255 

You can superimpose the two opposite patterns continuously so that 
the shape of the object being drawn does not change, but the object 
seems to be "vibrating" as the different patterns are switched on 
and off. 

60 PATTERN, FIRSTS 

70 AREA (10, 10) = AREA (300, 10) = AREA (150, 150) 
75 FOR I =1 TO 100= NEXT 
80 PATTERN, SECOND* 
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90 AREA (10, 10)= AREA (300, 10) : AREA (150, 150) 
100FORI = 1TO100: NEXT 
110 GOTO 60 

Notice that lines 75 and 100 are inserted in order to slow down 
the computer. The Amiga is so fast that you must add these delay 
lines to achieve the proper effect. If you delete lines 75 and 100 
.. • v: and run the program again, you will discover that the patterns are 

superimposed too quickly for creating quality graphics. 

Accessing and Saving Graphics 

Two Amiga BASIC commands enable you to take grapi*y images 
from the screen, save them in an array, and display them later. These 
two commands and their formats are 

GET (X1,Y1) - (X2.Y2), <array> 

PUT (X,Y), <array> 

You use GET to capture an image and put it into an array. To use 
this command, you type GET, then you type the X and Y coordinates 
of the upper left and lower right corners of the area that you want 
to capture. These two corners define the rectangular area of graphics 
that you want put »nto the array. Even if you are storing areas that 
are circular or some other shape, you still must encompass the shape 
in the confines of the rectangle you establish with the two corners. 

After you determine which rectangular portion of the screen you 
want to store, you need to set up a specific amount of memory for 
the array. Here is the formula for determining the amount of memory 
required: 

((width of rectangle in X pixels) * (height of rectangle in 
Y pixels) * 4) / 32 

For instance, if you want to store an image within a rectangle with 
an upper left corner of (20,20) and a lower right corner of (70,40), 
the width is 70 - 20, or 50, and the height is 40 - 20, or 20. Fifty 
times 20 equals 1000, multiplied by 4 equals 4000, divided by 32 
equals 125. This final number is what you would put after the DIM 
statement defining your array. If you were going to store this graphics 
image in an array called PICTR%( ), you would put the statement 
DIM PICfR%(125) somewhere near the beginning of the program. 
You always should set up the array before you use the GET 

command 
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Once an image has been saved in an array, you can perform other 
tasks in the program until you want to display the image again. When 
you want to redisplay the image, you type PUT, then you type the 
X and Y coordinates where you want the upper comer of the image 
to appear on the screen. With the PUT command, you can put the 
image anywhere on the screen. 

1 fk& 

Creating Superbear 

By using GET and PUT with the Bear Face program, you can create 
a Superbear that "flies" across the s-reeu in a single leap. You start 
with the simple Bear Face program you toiler in this chapter: 

5C0L0R3 
10CLS 

20 CIRCLE (150,90), 20 
30 PAINT (150,90), 1 
40 CIRCLE (130,80), 5 
*5 PAINT (129,79), 2 
c*} CIRCLE (170,80), 5 
60 PAINT (169,79), 2 
A5 COLOR 1 

80 CIRCLE (143,85), 2 
90 PAINT (143,85), 2 
100 CIRCLE (158, 85), 2 
110 PAINT (158,85), 2 

120 LINE (145, 98) - (148, 100) = LINE (148, 100) - (152, 100) : 
LINE (152, 100) - (154,98) 

130 LINE (148, 92) - (150, 90) : LINE (150, 90) - (152, 92) = 
LINE (152,92) - (148,92) 

You can change this program, which draws a bear's face, to make 
the bear's face move. First, set up enough memory to save the image. 

7DIMBEARW500) 

Next, save the shape by specifying the upper left and lower right 
coordinates of the rectangle encompassing the bear's face. 

140 GET (120, 70) - (180, 112), BEAR* 

Now, move the bear's face to many random locations. The result is 
a multitude of faces on the screen. 



150 PUT (RND*300, RND*150), BEAR*: GOTO 150 
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After you run this program and see the results, use the following 
lines to create Superbear. The program uses a FOR...NEXT loop to 
move the face to increasingly lower-numbered coordinates. The face 
moves up and to the left until it disappears beyond the screen at 
which point the program repeats the process so that the bear keeps 
"flying" the same route. 

150 FOR A =180 TO 0 STEP -1= PUT (A, A), 3EAR£: NEXT 
155 CLS 
160 GOTO 150 

Changing Red, Green, and 
Blue Color Levels 

If you want to change the values that make up any color register 
you use the PALETTE command, followed by the number of the 
color register you want to change and the three R, G, B numbers 
you want to change the color to. Suppose that you want color reg- 
ister 0 to have a red level of 10, a green level of 5, and a blue level 
of 12. You type 

PALETTE 0, 10, 5, 12 

To see the results of the changing value for each of the three color 
levels, run this program for as long as you like. Displaying all 4 096 
colors that are available on the Amiga takes quite a while. 
10 FOR R = 0 TO 15 
20 FOR G = 0 TO 15 
30 FOR B = 0 TO 15 
40 PALETTE 0, R, G, B 
50 NEXT: NEXT: NEXT 

Just Ask the Mouse 

PA n^rrp° n ^ phiCS ° UtpUt comman <*> such as PUT and 

PAXETTE, other graphics-related commands deal strictly with input 

S ^ f °g ram to a «*pt information from the "outside 

Zm h I u 8 * ^ m ° USe ' ke>Wd ' or some other d ^ce con- 
trolled by the user. 

MOUSE is an input graphics command that gets information from 
the mouse about the position of the graphics cursor on the screen 
chc suae or me ien mouse button. The most obvious use fS 
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MOUSE is to create a simple drawing program; the X and Y coor- 
dinates from MOUSE can be converted directly into graphics. When 
you use MOUSE in a program such as the one that follows, you can 
move the mouse to draw a picture. 

1CLS 

5 CO = i 

6 XX = HOUSE (i) : YX = MOUSE (2) : BY. = MOUSE ( 0 ) 

7 GOTO 40 

20 XX = MOUSE (1)= YX = MOUSE (2)= FX = MOUSE (0) 
25 IFBX = 1THENC0 = C0 + 1 = I F CO = 3 THEN CO <d 
30 LINE £0XX, OYX) - (XX, YX), CO 
40OXX = XX= 0YX = YX 
50 GOTO 20 

The variables X% and Y% specify where the mouse is currently point- 
ing, and OX% and OY% indicate the mouse's "old" location; these 
four variables tell the computer where to draw. Pressing the left 
mouse but on changes the color, but the variable CO (representing 
the color) is not allowed to go over 3. 

When you run the program, moving the mouse will allow you to 
draw (corresponding to the movement of the mouse) on the screen. 
Pressing the left button will change the color of your "drawing pen." 

You also can use the mouse to create shapes, as demonstrated in 
the following program. With this program, you can use the mouse 
to create boxes. First, you use the mouse to specify the upper left 
corner of the box. 

10CLS 

30 XX = MOUSE (1)= YX = MOUSE (2) = BX = MOUSE (0) 
40 IF BX = 1 THEN XIX = XX = YiX = YX ELSE 30 

After you push the left mouse button and put the values for the 
upper left corner into the variables Xl% and Yl%, the program 
pauses to give you time to release the button. The program then 
waits until you press the button again, then establishes the current 
location of the graphics cursor at the lower right corner of the box 

45FORD=1TO100= NEXT 

50 XX = MOUSE (1) : YX = MOUSE (2) : BX = MOUSE (0) 
60 IFBX=1THENX2X = XX: Y2X = YXELSE50 

Finally, the program draws the box, using the coordinates estab- 
lished. The program then loops back to line 30 to wait for another 
box to be drawn. 



Man tw$3 r? 
vari-*'- 
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70 LINE CXl^YlJi) - (X2/i,Y2X), CO, B 
80 GOTO 30 

As you may have realized, the mouse is a powerful input device. The 
mouse is suited especially for graphics because it can be moved in 
any direction with excellent accuracy. Amiga BASIC'S MOUSE com- 
mand is exclusively for getting input from the mouse device. By using 
the MOUSE (0) command, you instruct the computer to get infor- 
mation from the mouse. The current X-coordinate that the mouse 
represents wili be in the variable MOUSE ( 1 ); the Y-coordinate will 
be in the variable MOUSE (2). 

By us*ng the LINE command in conjunction with the mouse, you 
can create a drawing program with only a few lines of code: 

CHECKER : 

B = MOUSE (0) 
X = MOUSE ( 1 ) 

Y = MOUSE (2) 

LINE (0X,0Y) - (X, Y), 1 

Y = X;0Y = Y 
GOTO CHECKER 

For the next issuance of the LINE command, the values of X and Y 
again are stored in different variables (OX and OY). This is because 
the Amiga needs to know where the drawing pixel currently is lo- 
cated on the screen. While running the previous program, you can 
draw by moving the mouse around. Also, you can create straight 
lines by moving the mouse to the point where you want the line 
to start, holding down the right mouse button as you move the 
pointer to the place where you want the line to end, and then re- 
leasing the button. 

With a slight modification, you can have a program that also allows 
you to change the color of the line being drawn: 

C = i 

CHECKER: 

B = MOUSE (0) 

X = MOUSE (1) 

Y = MOUSE (2) 

LINE (0X,0Y) - CX,Y), C 

DX = X: 0Y = Y 

IFBTHENC = C+1: IFC = 4THENC = 0 
GOTO CHECKER 



106 



AMIGA PROGRAMMING GUIDE 



You still can use the right mouse button to draw lines, but now you 
also can use the left mouse button to change colors. Moreover, by 
holding down the left mouse button, you can get the color of the 
drawing pixel to change continuously as you draw. 

The next program uses both the MOUSE and the AREA commands. 
With this program you click the mouse button at five different points 
in order to define a five-pointed solid area. The FOR... NEXT loop, 
which uses the variable D, slows the computer so that it won't in- 
terpret one click of the mouse button as several clicks. 

COLOR 1 
CHECKER: 

B = MDUSE (0) 
X = MOUSE (1) 

Y = MOUSE (2) 

IF B < 0 THEN AREA (X, Y) = NP = NP + 1 ■ FOR D = 1 TO 750= NEXT 
IF NP = 5 THEN AREAFILD NP = 0 
GOTO CHECKER 

Because the Amiga is such a. fast machine, even BASIC programs can 
be used to create complex three-dimensional graphics. With this 
next program, you can move the mouse around the screen (while 
holding down the left button) and duplicate a circle hundreds of 
times. As you move the mouse in die direction you want the circle 
to be duplicated, you create a three-dimensional pattern. 

CIRCLE (100, 100), 50 
DIM P (1000) 

GET (50,50) - (150, 150), P 
CHECKMOUSE: 

X = M0USE (i) 

Y = M0USE (2) 
B = MQUSE (0) 
IFB<0THENPUT(X,Y), P 

GOTO CHECKMOUSE 

If you want just to move an element rather than duplicate it, you 
can use CLS to clear the screen every time the object is moved. The 
Amiga does this so quickly that the object seems to move smoothly 
without any "flickering." The following program allows you to move 
a cube around the screen by means of the mouse: 

DIM P (2000) 
COLOR 2 

LINE (50,50) - (150, 100), , B 
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LINE (75, 40) - (175,90), , B 
LINE (50, 50) -(75, 40) 
LINE (150, 100) -(175, 90) 
LINE (50, 100) - (75, 90) 
LINE (150, 50) - (175,40) 
GET (50, 40) - (175,100), P 
CHECKMOUSE: 

X = MOUSE (1) 

Y = M0USE(2) 

B = MOUSE (0) 

IF2<0THENCLS= PUT (X, Y), P 
GOTOOEOmJSt 



Putting It All Together 

In this chapter, you have learned the fundamentals of producing 
graphics with Amiga BASIC. Now you can put your knowledge to 
use by writing some programs that use some of the commands you 
know. 



Moving Blocks of Graphics 

The following program demonstrates the usefulness of the PUT and 
GET commands. It draws a random graphics picture on the screen 
then allows you to use the mouse to move blocks of graphics around' 
First, you use random CIRCLE and LINE commands to create the 
graphics. 

10CLS 

20 FOR I = 1 TO 60 

30 CIRCLE (RND»300, RND*150), RND*60 
40LINE(RND*250,RND*i50) - (RND*300, RND-150) RND*3 BF 
50 LINE STEP (RND*300, RND*150) 
55 COLOR RND*3 
60 NEXT 

After the graphics are on the screen, the program begins to monitor 
the mouse and waits for the button to be pressed (B% equals 1). 

70 X> = MOUSE (1) i T/. = MOUSE (2) = BK = MOUSE (0) 
80 IF B/.O A THEN GOTO 70 
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When you press the button the first time, the program is signaled 
that you have selected the upper left coordinate of the rectangle of 
graphics to be moved. The program stores those X and Y coordinates 
in the variables X(l) and Y(l). The program pauses so that you 
have time to release the mouse button. If the pause is not included 
in the program, the program might "think" that you are pressing 
the button again. 

95FORD = iTO200; NEXT 

The program waits for the button to be pressed a second time. When 
tin* ; "ppens, the program stores the X and Y coordinates in the 
variables ^(2) and Y(2) and figures out how much memory space 
to allocate for the array that will hold the graphics-filled rectangle. 

100 »i = MOUSE (i)=YZ = HOUSE (2)= B/. = MOUSE (0) 
110 IFE/.O 1 THEN GOTO 100 

120 x(2) =yy.- Y(2) =r/. 

130DM = X(2) -X(l) 

131 DM = DM * (Y(2) - Yd) 

132 DM = (DM « 4) / 16 
140 DIM (DM) 

Now the program "grabs" the shape, stores it in GRS%, and pauses 
again to let you release the button. For the third time, the program 
monitors the mouse. Pushing the left button signals the program 
that you want to place the graphics rectangle in the location that 
the mouse is currently pointing to. The PUT statement tells the 
program to place the shape in that location. In line 200, the program 
resets itself so that it can redimension the GRS% array and move 
another graphics rectangle. 

150 GET <XC1),YCD) - (X(2), Y(2)), DRSZ 
160FORD = 1TO200= NEXT 

170 XX = MOUSE (1): YZ = MOUSE (2)= BX = MOUSE (0) 
180 IF BZ O 1 THEN GOTO 170 
190 PUT (X/., Y/.), GRSX 
195FQRD = 1TQ200: NEXT 
200 CLEAR : GOTO 70 

Setting Up Patterns 

The next two sample programs could be a big help to you if you 
have trouble figuring out what numbers to use with the PATTERN 
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command. With the first program, you can set up an eight-byte pat- 
tern by pointing the mouse at the part of the pattern that you want 
to fill, then clicking the left mouse button. You can turn a part of 
the pattern on or off by clicking the button while the arrow is point- 
ing inside that box; clicking the button causes the box to change 
its state. 

First, the program sets up the boxes in the same format as PATTERN 
will use to create the pattern: four boxes down by two across. 

5 CLEAR 
10CLS 

20 FOR Y = 30 TO 90 STEP 20 

30 FOR X = 30 TO 90 STEP 40 

33 Lir£ (X, Y) - CX+40, Y+20), 1, B 

35C0 = C0+1: COLOR CO 

37 PAINT (X+l, Y+l) 

50 NEXT: NEXT 

Because each box is a different color, when you point to a box and 
click the button, the program can use the POINT command to de- 
termine what box to change according to the pattern you are pro- 
gramming. The program also monitors the keyboard and, when you 
press P, jumps to line 500 to calculate the numbers for the pattern 
you created. 

60 X* = MOUSE (i): r/. = MOUSE (2) = BX = MOUSE (0) 
65 A$ = INKEYS- - IF A$ = "P" OR A$ = "p" THEN GOTO 500 
70 IF CI THEN GOTO 60 
80 CC = POINT tx/.,r/.) 

90 IF PP(CC) = 1 THEN PP(CC) = 0 ELSE PP(CC) = 1 
100FORD=1TO200: NEXT 
110 GOTO 60 

After you specify the kind of pattern you want to create, the program 
does the hard work for you by calculating and printing the value of 
each of the four numbers that make up the pattern. 

500 FOR I = 1 TO 7 STEP 2 

510 R(I) = PP(I)*65280 + PP(I +1) «255 

520 NEXT 

525 CLS 

530FORU1TO7STEP2: PRINT R( I) : NEXT 

The following program uses the same idea as the first program but 
is somc-nrhflt inurt «iv*nccu. wiien you press P, the pattern is pro- 
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grammed into the computer, and the computer displays a shape that 
uses that pattern. The first part of the program is almost exactly like 
the last one: 

5 CLEAR: CT = 0 

10CLS 

23 FOR Y = 30 TO 90 STEP 20 

30 FDR X = 30 TO 90 STEP 40 

33 LINE (X, Y) - (X440, Y+20), CO, BF 

35 COLOR CO: CO CO + 1 

37 PAINT (X+i, 

50 NEXT : NEX. 

60 W. = MOUSE (1) = u. - MOUSE (2) ■ BX = MOUSE (0) 
65 A$ = INKEY$ : IF A$ = "f- GR A$ = "p" THEN GOTO 500 
70 IF BXOl THEN GOTO 60 
80 CC = POINT w.,m 

90 IF PP(CC) = 1 THEN PP(CC) = 0 ELSE PP(CC) = J 
100FORD = 1TO200: NEXT 
110 GOTO 60 

The next part of the program calculates the numbers for the pattern 
and uses the pattern to draw a box. After you press any other key 
but P on the keyboard, the program sets the pattern baclr to what 
it was before (solid) and goes back to line 5 so that you can try 
out another pattern. 

500 FOR I =0TO6STEP2 

510RU) =PP(I) *65280 + PP(I + 1) *255 

520 NEXT 

525 CLS 

530 FOR I = 0 TO 6 STEP 2- PJi(CT) = R( I) : CT = CT + 1 ■ NEXT 
540 PATTERN, F/.i ) 
550 CLS 

560 LINE (10, 10) - (200, 150), CO, B 
570 A$ = INKEYS 

580 FOR I = 0 TO 3= F/.t I ) = 65535: NEXT: PATTERN, F/.i ) 
590 GOTO 5 

Pick Your Polygon 

Until now, the programs that included AREA commands have used 
the RND statement to create random polygons. The next program 
enables you to move the mouse and click the button at five different 
locations in order to create a five-pointed polygon made out of those 
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points. With this program, you also can change both the color of 
the polygon (by pressing C) and the color of the border of the 
polygon (by pressing B). First, you specify the coordinates of the 
five points. 

10CLS 

20FORI = 1TO5 

30 X* = HOUSE (1) : T/. = MOUSE (2) : R£ = MOUSE (0) 
35A$=INKEY$: IF A$ O THENGOSUB 100 . , 

40 IF BKOi THEN GOTO 30 
50XU) =X*: Yd) =r/. 

55 FOR D = 1 TO 200 : NEXT 
60 NEXT 

Next, the program draws the figure on the screen and returns to 
line 20 to monitor the mouse and keyboard. 

70 AREA CXC1), Yd)) : AREA (XC2), Y(2) ) = AREA (XC3), Y(3)) = AREA 
<X(4), YC4) ) : AREA <X(5), Y(5) ) = AREAFILL 
80 GOTO 20 

If the program detects in line 35 that a key has been pressed the 
program jumps to line 100. In the lines that follow, the program 
increases the value of the interior color by 1 if C is pressed and 
increases rhe value of the outline color by 1 if B is pressed. If either 
of these values goes above 16, the program brings the value back 
down to 1. 

100IFA$="C"ORA$="c"THENCO = CO + l: IF CO > 3 THEN CO = 0 
105IFA$="B"ORA$="b"THENOT = OT + l: IF 0T > 16 THEN 0T - 1 
110 COLOR CO, 0T RETURN 

To observe another interesting animation effect, run the following 
program. This program places a circle on the screen and randomly 
increases or decreases X and Y values. First, you establish the X and 
Y values and draw the circle. 

5 COLOR 2 
10CLS 

20X = 50: Y = 50 
30 CIRCLE (X, Y), 8 

Now you set the pen color to 0 (the color of the screen) and draw 
the circle again in order to increase or decrease randomly both the 
X and Y values and to make sure that the values are within the 
permissible limits of the screen. Then you set the pen color back 



112 



AMIGA PROGRAMMING GUIDE 



to black and return to line 30 so that you can continue to move 
the circle around 

35 COLOR 0= CIRCLE (X, Y), 8 

40DURND*2: IF INT(CX) = i THENX = X + 2ELSEX = X - 2 
50CY = RND»2: IF INT(CY) - i THEN Y = Y + 2 ELSE Y = Y - 2 

53 IF X > 300 THEN X = 300 ELSE IF Y > 180 THEN Y = 180 

54 IF X < 0 THEN X = 0 ELSE IF Y < 0 THEN Y = 0 

55 COLOR 1 
60 GOTO 30 



A Drawing Program 
That Uses the Keyboard 

Although you have seen several times how useful the mouse can be 
in programs, you should not neglect other computer components 
that can be useful input and output devices. The keypad, for example, 
makes an excellent drawing tool because you easily can use it to 
specify upward, downward, left, right, and diagonal motion. For in- 
stance, the 8 key can specify "up"; the 2 key, "down"; the 1 key, 
"down and left"; and so on. 

The following drawing program uses the keypad to find out the 
direction in which you want to draw. Among the other commands 
included in the program are these: 

"5" Toggles the pen on and off so that you can either 
draw or simply move around the screen 

"0" Changes the color of the pen 

Starts the program over again. You have to press 
this key twice in order to verify that you want to 
start over. 

"-" Fills the bounded surroundings of the graphics 

cursor with a random color 

• M 
You start the program by specifying what color (represented by the 

variable DR) you want to use and what the X and Y coordinates of 
the graphics cursor are. 

5DR = 1 

10CLS 

20X = 150 
30 Y = ytj 

35 PIXEL (X, Y) 
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Now the program can begin to monitor the keyboard. Each key 
either alters the X and Y values or performs one of the other func- 
tions already mentioned. 

40A$ = INKEYS 
50IFA$="8"THENY = Y-1 
55IFA$="l"THENX = X-i: Y = Y + i 
57 IFA$ = "3"THENX = X+i: Y = Y+1 

60 IF A$ = "2" THEN Y = Y + 1 

61 IF A$ = "7" THEN X = X-1=Y = Y-1 

62 IFA$ = "9" THENX = X + 1 : Y = Y - 1 
70IFA$="6"THENX = X + 1 
80IFA$="4"THENX = X-i 

81 IF A$ = "5" THEN IF DR = 1 THEN DR = 0 ELSE DR = 1 
82IFA$=". " THEN GOTO 110 

83 IFA$ - "=" THEN COLOR RND * 3 = PAINT (X, Y) 1 

84 IF A$ = "0" THEN DR = RND * 3 

The program checks ro see whether the X and Y values are "out of 
bounds" and corrects them if they are. The LINE command does 
the drawing. Line 100 sends the program back to the At = INKEY* 
command so that the program can continue checking the keyboard. 
Lines 120 through 140 wait for you to push the period (.) key a 
second time in order to verify that you want to run the program 
again. If you press a key other than the period, the program returns 
to the regular drawing routine. 

85 IF X > 300 THEN X = 300 ELSE IF X < 0 THEN X = 0 
87 IF Y > 180 THEN Y = 180 ELSE IF Y < 0 THEN Y = 0 
90 LINE STEP (X,Y), DR 

100 GOTO 40 

120 A$ = INKEY$= IF A$ = " " THEN GOTO 120 
130 IF ft$ = ". " THEN GOTO 5 
140 GOTO 40 

You can add an additional feature— changeable drawing speed— to 
this program by making only a few alterations. First, you add the 
following two lines: 

3IN = 1 

83 IFA$ = CHR$(13) THEN IN= IN + 1 = IF IN = 6 THEN IN = 1 

Line 83 increases the value of IN (your drawing speed) by 1 if you 
press the RETURN key. After IN reaches 6, it goes back down to 1. 
Change al! the nrn.rr P nr PC "fj-/in linee 50 to 80 to i /iY, and change 
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all the occurrences of -/ in lines 50 to 80 to -IN. Lines 50 through 
80 now should look like this: 

50 IF A$ = "8" THEN Y = Y - IN 

55IFA$ = "1"THENX = X-IN: Y = Y+IN 

57IFA$="3"THENX = X+IN: Y = Y+IN 

60 IF A$ = "2" THEN Y = Y + IN 

61 IF A$ = "7" THENX = X - IN : Y = Y - IN 

62 IFA$= "9" THENX = X + IN : Y = Y - IN 
70IFA$ = "6"THENX = X+IN 

80 IF A$ = "4" THEN X = X - IN 

How To Set Colors with PALETTE 

The last few programs presented here will help you discover the 
real power of the PALETTE command, a command touched on ear- 
lier in this chapter. PALETTE enables you to access the Amiga's 4 096 
colors. Although you can display only 32 colors at a time, such a 
variety of colors makes almost any kind of graphics possible. 

Using the PALETTE command, you can randomly change the colors 
of colored circles. 

10CLS 

20 FOR X = 0 TU 3 

25XX = RND*250 + 20: YY = RND * 160 + 20 

30 CIRCLE (XX, YY), 30 

33 COLOR X 

35 PAINT (XX, YY) 

40 NEXT 

60FORCO = 0TO3 

70 PALETTE CO, RND*16, RMM6, RND*16 
90 NEXT 
100 GOTO 60 



A Color Finder Program 

™ < W?£ 8ram ^ f S ? aptCf iS a P ro g™™er's tool that helps 
you find the one color that you are looking for out of 4,096 The 
following keyboard commands are used in this program (once again 
the keypad is used extensively): 8 ' 



"1" Raise red level. 
"4" Bring red level back to default. 

Lower red level. 
"2" Raise green level. 
"5" Bring green level back to default. 
"8" Lower green level. 
"3" Raise blue level. 
"6" Bring blue level back to default. 
"9' Lower blue level. 

Go back to normal colors and clear the screen. 
The program fills a box on the screen with whatever color you set 
and the levels for red, green, and blue appear just below the box 
After you are satisfied with the color you have found, you can write 
down the PALETTE number so that you can use the color later in 
another program. 

You begin this program by setting aside enough memory for the 
arrays you are going to use, then clearing th^ -reen. 

5DIMRC15). GC15), BUS) 
7DIMRR(15), GG(15), BBU5) 
10CLS 

The R, G, and B arrays store the current color levels of the colors 

T^T™ 1 ?^? 1 - ™ C **• md BB ™v* h °W the colors' 
default (regular) values, which are reset when the program ends. 

The program reads into memory the default values of th<rred, green 
and blue levels for the 16 different color registers. ' 
20 FOR CO = 0 TO 15 

SSSS'M B(C0) : PALETTE CO, RCCO), G(C0) , B(C0) 
35 RR(CO) = R(C0) : GG(CO) = G(C0) : BB(CO) = B(CO) 
40 NEXT 

50 DATA 6, 9, 15 
60 DATA 0, 0, 0 
70 DATA 15, 15, 15 
80 DATA 15, 9, 10 
90 DATA 14, 3, 0 
iee DrtTrt 15, n, 0 
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110 DATA 
120 DATA 
130 DATA 
140 DATA 
150 DATA 
160 DATA 
170 DATA 
180 DATA 
190 DATA 
200 DATA 
210 DATA 



15, 15, 2 

11, 15, 0 
5, 13, 0 
0, 14, 13 
0, 13, 15 
7, 13, 15 

12, 0, 14 
15, 2, 14 
15, 13, 11 
12, 9, 8 
11, 11, 11 



A r> \,Yf\- : .-r'-r. 

tiSifJte Fi> it'f. C 



Next, the program asks which color register you would like to alter, 
chooses that pen color, and draws the color-filled box. 

220 INPUT "Uhich color do you want to change"; C 
225 COLOR C 

230 LINE (10, 10; 300, 150), 1 

Like the earlier programs, this program also monitors the keypad. 
Values for the red, green, and blue levels are altered according to 
the keys pressed. 

240 A$ = INKEY$ 

250 IF A$ = "7" THEN R(C) = R(C) - 1 
260 IF A$ = "4" THEN R(C) = RR(C) 
270 IF A$ = "1" THEN R(C) = RCC) + 1 
280 IFA$ = "8" THENG(C) = G(C) -1 
290 IF A$ = "5" THENG(C) = GG(C) 
300 IF A$ = "2" THEN G(C) = G(C) + 1 
310 IF A$ = "9" THEN B(C) = B(C) - 1 
320 IF A$ = "6" THEN B(C) = BB(C) 
330 IF A$ = "3" THEN B(C) = B(C) + 1 
335 IF A$ = "-" THEN GOTO 400 

As usual, the program makes sure that none of the values go out of 
bounds. 

340 IFR(C) < 0 THEN RCC) = 0 ELSE IF RCC) > 15 THEN RCC) = 15 
350 IFGCC) < 0 THENGCC) = 0 ELSE IFGCC) > 15 THENGCC) =15 
360 IF BCC) < 0 THEN BCC) = 0 ELSE IF BCC) > 15 THEN BCC) = 15 

Now the program sets the PALETTE color and prints the values. 

370 PALETTE C, RCC), GCC), BCC) 

375 LOCATE 0, 21 : PRINT RCC), GCC), BCC); 
350 GOTO 240 
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At the end of the program, the values are reset. 

400FORC = 0TO15= R(C) = RR(C): G(C) -GG(C)= B(C) = 
BB(C): h£XT 
410 CLS 

The programs in this chapter have illustrated how powerful just a 
few lines of compact programming code can be. Now that you have 
learned the fundamentals of programming graphics in Amiga BASIC, 
you can begin using more complex graphics and sounds. 
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5 

Sounds, Music, and Speech 



Until recently, the most that personal computers could offer in the 
way of music or voice synthesis was accessible only through com- 
plicated assembly language commands and programming tricKS. Only 
the most experienced and knowledgeable programmers could make 
computers play a simple song or sound, and making a computer 
"say" a few intelligible words was a real accomplishment. 

With the Amiga, you can create sounds, music, and speech directly 
through Amiga BASIC, and producing any of these three is very sim- 
ple compared to methods that were formerly used. In this chapter, 
you will look at how to make the Amiga emit sounds, music, and 
words. Furthermore, you will learn how to take advantage of the 
Amiga's stereo sound. 

You don't have to hook up a stereo to the Amiga to run the programs 
in this chapter. However, some of the programs do work in stereo, 
and you will need two speakers in order to enjoy the "dual sounds." 
Connecting a stereo to the Amiga is easy enough. Using a portable 
"boom box" stereo is recommended, but you can use a full-blown 
system if you like. Get two phono cables (the RCA-type plugs used 
to hook stereo components together) and plug one end of each into 
the Amiga's sound output ports (on the back of the computer, un- 
derneath the pictures of speakers). Plug the other end of each phono 
cable into the input port of your stereo. 

Here are some tips that will save you trouble when you use the 
Amiga with a stereo: 

1. Make sure that the plug hooked into the right 
speaker output of the Amiga is connected to the 
right speaker input of your stereo. Do the same for the 
icfi speaker. 
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2. Keep your stereo volume low at first, then gradually 
turn it up until you are satisfied with the sound level. 

3. Although stereos differ, you probably will find the input 
port of your stereo by looking for the phono plug 
input labeled Line input or Phono input. If you run 
into trouble, check your stereo manual. 

If you aren't going to use a stereo, make sure that your monitor's 
sound is or* so that you can hear the sounds and words that the 
Amiga proc 'ices. 

Amiga Sounds Off 

If you have used the documentation and you haven't gotten good 
results, the information and sample programs in this chapter should 
help clear up your confusion. Using the tips here, which are based 
on practice and experience, will help you best reali2e the potential 
of the Amiga's sound. 

If you have tried to make sounds with the Amiga and have been 
frustrated, you are not alone. Even someone who has been working 
with computers for years could spent a long time figuring out how 
to use the sound commands. You can rest assured that you will get 
the "true story" in this chapter. You will learn the problems that 
arise when you use Amiga BASIC and how to avoid them. This chap- 
ter will steer you in the right direction so that your sound programs 
work properly. 

Aspects of SOUND 

The most fundamental sound command is SOUND. You can use the 
SOUND command to tell the computer which voice to send a sound 
through, which speaker(s) to play the sound through, how long to 
play the sound, and what the sound's volume and pitch should be. 
The format of the SOUND command is 

SOUND <frequency>, <duration>, <vo!ume>, <voice> 

The elements of the SOUND command are explained as follows: 

<frequency> This can range from 20 to 15,000, with 

larger rmmfvrs gfn<= rating "higih^j-.pit^KeH 

sounds. 
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<duration> 



<volume> 



<voice> 



This can range from 0 to 77, where one 
second equals 18.2. The higher the number, 
the longer the sound will last. 

This is the sound's volume. This element 
determines the volume of the sound for its 
entire duration, and it can range from 0 
(no sound) to 25 (loudest sound). 

A 0 or 3 value will send the sound to the 
left speaker, while 1 oi 7 will <send it to the 
right speaker. 



Table 5.1, reproduced from the Amiga BASIC Manual, provides a list 
of musical notes and their corresponding frequencies. 

One of the best features of the SOUND command is that the Amiga 
can do other tasks while a sound is being played. On most other 
computers, everything else stops until the sound finishes playing In 
addition, if you issue several SOUND commands, the Amiga retains 
them all in memory and plays them in order. However, if you send 
the Amiga too many SOUND commands, an Out of Workspace error 
occurs. 



Sample Sounds 

The sample programs that follow will let you hear what SOUND can 
do. Before you begin, make sure that your computer is in Amiga 
BASIC and that your stereo (or single speaker) is on. 

This first program sends sounds of random volume and pitch to 
random channels. The program demonstrates how fast the SOUND 
command works. The results are interesting to listen to. 

20 SOUND RND * 1000 + 20, 2, RND * 255, INT (RND * 3) 
30 GOTO 20 

The next program produces a rapidly descending tone. As the vari- 
able in the FOR... NEXT loop decreases in value, the tone becomes 
lower. 

10 FOR I = 3000 TO 500 STEP -15 
20 SOUND I, .2 
30 NEXT 

As you can guess by running these programs, you could create a 
whole library of sounds simply by using different pitches and 
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Table 5.1 

Musical Notes and Their Corresponding Frequencies 



Note 


Frequency 


Note 


Frequency 


C 


130 


A 


440 


C# 


138 


S 


493 


D 


146 


C 


523 (middle C) 


D# 


155 


D 


587 


E 


164 


t 


659 


F 


174 


F 


701 


F# 


185 


G 


783 


G 


196 


A 


880 


G# 


207 


B 


993 


A 


220 


C 


1046 


AM 
r\Tt 




n 


1 174 


3 


246 


E 


1318 


C 


261 


F 


1396 


D 


293 


G 


1568 


E 


329 


A 


1760 


F 


349 


B 


1975 


G 


392 







FOR...NEXT loops. By moving a pitch up or down (or oscillating 
the pitch up and down) at a certain speed, you can produce a unique 
tone. Try altering the FOR... NEXT loop in line 10 to see what sounds 
you can produce. 

The Musical Computer 

As mentioned earlier, you can create musical notes by using certain 

piuJi values. Hie iiCAt program plajs the A riolcs 3paiming air ccta»c 

by using the information stored in a DATA statement. 
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SDIhAXCB) 

20 FDR P = 1 TO 8: READ A*(P) = NEXT 
30FORP=1TO8 
40 SOUND mP), 10 
50 NEXT 

60 DATA 130, 146, 164, 174, 196, 220, 246, 261 

The program sends notes that ascend in pitch through the right 
channel Change the following line so that the notes move downward 
in pitch through the left channel: 

40 SOUND AX(P), 10, , 1 

Now type the following additional line, which is almost the same 
as line 40 in the original program: 

45 SOUND AXC9-P), 10, , 0 

The notes move up in pitch in one speaker, down in pitch in the 
other speaker. Experiment with the program to see what different 
effects you can achieve with the two speakers. 

To make sure that you understand the concept of stereo sound and 
the procedure used to create it, type the following program. The 
first line makes the computer send random sounds to the right 
speaker, and the second line sends random sounds to the left 
speaker. 

10 SOUND RND * 300 + 20, 5, , 0 
20 SOUND RND * 300 + 20, 5, , 1 
30 GOTO 10 

This program keeps looping back to line 10 so that the notes 
"bounce" back and forth between the speakers. 

Cranking Your Amiga 

The next program is similar to the last one, but goes a step further 
by modifying the volume of the SOUND commands as the program 
runs. The program starts off with maximum volume in one speaker 
and silence in the other speaker. As the FOR. ..NEXT loop progresses, 
the loud speaker grows quieter, and the once-silent speaker becomes 
louder. After the two speakers "sw itch roles," the process reverses 
itself so that the sound grows louder in the speaker that was silenced. 
This entire process keeps repeating, which creates the effect of a 

swwnd bouncing from one opcakcr lo tuiutlitr and back again. 
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20 FOR V = 1 TO 255 
30 SOUND 250, . 3, V, 0 
40 SOUND 250, .3, 256 - U, 1 
50 NEXT 

60 FOR U = 254 TO 0 STEP -1 
70 SOUND 250, .3, U, 0 
80SOUND250, .3, U, 1 
90 NEXT 
100 GOTO 20 

• - 

Next, try a program that makes the sound grow higher in pitch in 
one speaker ai ' 'owe in pitch in the other speaker. 

20 FOR P = 100 TO 1000 S ffcT *5 
30 SOUND P, 1, , 0 
40 SOUND 1100 - P, 1, , 1 
50 NEXT 

You can modify this program so that all four channels are used. 
Remember that each speaker has two channels, so the effects you 
can produce with all four tones can be quite interesting. Type the 
following lines: 

35SOUNDP + 500, 1, , 2 
45 SOUND 1600 - P, 1, , 3 

Take some time now to review what you have learned about SOUND. 
After you master this command, make some sounds of your own 
and work up to using two different speakers. 



Music and the Amiga 

You can produce real music on the Amiga in a number of ways 
including using the commercial Musicraft® program, hooking up a 
synthesizer to your computer, or using the musical keyboard from 
Commodore®. In this section, you will examine one of the easiest 
methods: using the SOUND command. You can use the SOUND com- 
mand to create notes, and you can change the notes' duration by 
altering the second element in the SOUND command. 

The next program is an effective tool for punishing unruly children 
who spill drinks on your Amiga. (To see what this means, you will 
have to type and run the program.) The program sets up an array, 
P%(|), to hold the musical notes. Setting up arrays makes writing 

programs easier, and you probably will want lO UO tUlS In all the 
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music programs you write. After setting up an array, the program 
reads the pitch values for these notes into the array. 

SDlMF/iUS) 

20FORI = 1TO13: READ F/M) - NEXT 

30 DATA 130, 138, 146, 155, 164, 174, 185, 196, 207 

To play the notes, you set up a subroutine that sends one pitch 
(stored in variable P%(P1)) to one channel and the other pitch 
(variable P%(P2)) to the other channel. 

500 SOUND P;«Pi), 5, , 0= SOUND P*/:<P2), 5, , . 
510 SOUND 14000, 1, 0, 0: SOUND 14000, 1, 0 1 
520 RETURN 

Now all you have to do is tell the Amiga which two notes-specified 
by the numbers in the variables PI and P2-you want the speakers 
to play. Then you have to issue a GOSUB 500. The program stores 
notes 1 through 13 in the P%( ) array; therefore, the PI and P2 
variables, used in conjunction with the P%( ) array, have meaning 
For example, if PI equals 4 and P2 equals 7, then the program goes 
to the subroutine at line 500 and plays the pitches stored in variables 
P%(4) and P%(7). 

Line 35 specifies die first three pairs of notes that the Amiga plays. 
35 DATA 6, 8, 5, 8, 3, 12 

The computer plays each pair of notes six times, pausing at line 70 
before playing each pair. 

37FQRJ = iT03: READ PI, P2 
40 FOR I = 1 TO 6 
50 GOSUB 500 

70 FOR D = 1 TO 300 = NEXT : NEXT 
80 NEXT 

The Amiga plays notes 1 and 13 once, pauses, plays them again 
pauses, and plays them one more time. ' 

90P1 = 1: P2 = 13: GOSUB 500= FORD = 1TO500: NEXT 

100 GOSUB 500: FORD=1TO300: NEXT: GOSUB 500: FORD-1 

TO 300 : NEXT 

The computer plays two more pairs of notes, pausing before plavine 
each pair. • * 1 * 

110P1=3: P2=12: GOSUB 500: FORD=1TO300: NEXT 
120 PI =5: P2 = 8= GOSUB 500: FORD=1TO300: NEXT 



126 



AMIGA PROGRAMMING GUIDE 



The program then uses the RESTORE command to reset the DATA 
statements so that they can be used again. Then the program goes 
back to line 20, The computer keeps playing the song indefinitely 
(until someone throws a brick at it or until you press Ctrl-C). 

140 RESTORE = GOTO 20 

You can use many of the elements in this program to create your 
own songs on the computer. Furthermore, by using the Amiga's mul- 
tiple channels (sometimes called voices}, you can create chords and 
complex musical pieces. 



Altering the Waveform 

When the Amiga produces a sound, the tonal quality of the sound 
is based on its waveform. The waveform, which is made up of points 
on a graph ranging from 127 to -128, tells the computer the nature 
of the sound wave. 

The default waveform of the SOUND command is a sine wave, which 
goes from 0 to 100, back down to 0, down to -100, and back up 
to 0. The wave is a smooth curve; the computer stores the points 
that roughly describe the wave then "smooths out" what the wave 
should sound like based on 256 points on the curve. If the computer 
plays this sound wave more than once (which is likely because even 
playing it 50 times produces only a short beep), the wave goes up 
to 100, down to -100, up to 0, and then gets ready to go up to 100 
again with the second wave. 

By using the points from -128 to 127, you can create any waveform 
you like. These points are stored in an array. You can tell the com- 
puter to make your new waveform by using the WAVE command, 
which has the following format: 

WAVE <number>, <array> 

The number variable tells the computer which voice the sound will 
be played through (which can range from 0 to 3), while the array 
is the name of the integer array where the points of the graph are 
stored. When you determine what kind of waveform you want to 
produce, try to use enough points so that the computer has enough 
information to make a graph close to what you want; you will need 
at least i*>b points. 
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The following program defines a waveform that goes from 0 to 1 17, 
from 1 17 to -1 17, and from -1 17 to 0. To begin, set up the waveform 
from 0 to 117. 

5DINUXC260) 

20FORU0TO65-- UKU3 = 1*1.8= NEXT 

Next, put into the array the points that go from 1 17 to -1 17 in steps 
of 1.8. Notice that by using the variable I from the FOR... NEXT loor> 
in the simple formula W%(I) = 1.8 * (1301), you are usii— the 
variable to accomplish two things: to tell the computer wLr *he 
array variable is and to determine the value for that point in the 
graph. 

30 FOR I =66 to 130: UJi(I) =1. B* (130 -X) : NEXT' FOR I = 
131 to 195= U/i( I) = -1.8* (130 - X) : NEXT 

To complete the waveform, set up the last point on the graph, issue 
the WAVE command, and start the sound. 

40 FOR I =196 to 260: (JK(I) = -1. 8 (260 - X) ■ NEXT 

50UAUE0, W. 

60 SOUND 2000, 25, , 0 

This next program, which is a little less "orderly" than the last one, 
creates random waveforms and plays each one for you. You can hear 
the results of changing waveforms as different tones are produced. 

20 FOR I =0 TO 256: W.( I ) = 127 - RND * 254 : NEXT 

30UAUE0, UK(I) 

40 SOUND 500, 10, , 0 

50 GOTO 20 

The last program that uses the WAVE command helps you develop 
your own waveforms. You can use the keypad to make a waveform 
slope up, slope down, or go directly up or down. After you make 
the waveform, you can tell the computer to play it. You also will 
be able to see the waveform represented graphically on the screen. 

Begin the program by setting up the array and drawing the graph 
to be used to make the waveform. 

20 DIM l&(256) 
30CLS 
40C = 0 
□0 COLOR l 

60 REM Set up graph for uaue 



128 



AMIGA PROGRAMMING GUIDE 



70LINE (10, 10) - (10, 138) 
80 LINE (10, 74) - (250, 74) 
90 LINE (250, 74) - (10, 74) 

Now, program the computer to set up the current location of the 
graphics drawing pixel (at 10,74) and to begin monitoring -the 
keyboard. 

100Y = 74: oy = 74= X = 10 = OX = 10 

110 A$ = INKEY$ : IF A$ = "" THEN 110 v 

If you press 6, the cursor moves right by 1 pixel, and Eke program 
increments its counter by 1 for the points on the graph (determined 
by the variable C). 

i20 IF A$ = "6" THEN X = X + l= C = C + i 

Next, the program checks to see whether the 9 or 3 key has been 
pressed, if the 9 key has been pressed, the graphics pixel moves up 
diagonally by 1 point. If the 3 key has been pressed, the pixel moves 
down diagonally by 1 point. As you are forming the graph, pixels 
will be left behind to indicate how it is shaping up. 

130 IF A$ = "9" THFNY = Y - 1= X = X+1=C = C+1 
140 IFft$ = "3 ,, THENY = Y+1^ X = X+1^ C = C+1 

If the 8 key is pressed, the cursor moves up 1 point vertically. The 
counter (C), however, is not affected because going up does not 
make a new point for the waveform. Pressing 8 lets you draw square 
waves by moving straight up, directly across, and straight down. The 
key to press to go straight down is 2. 

145 IF A$ = "8" THEN Y = Y - 1 : LINE STEP (X, Y) 
147 IF A$ = "2" THEN Y = Y + 1 = LINE STEP (X, Y) 

When you want to play the sound, you press P. The program checks 
for either a lowercase or uppercase P. 

150 IF A$ = "P" OR A$ = "p" THEN GOTO 200 

Then the program makes sure that the X and Y values are within 
their bounds. If Y is out of bounds, the Amiga corrects it. If X is 
out of bounds, the computer automatically jumps to the routine that 
plays the sound. 

160 IF Y < 10 THEN Y = 10 ELSE IF Y > 138 THEN Y = 138 
180 IF X > 256 THEN GOTO 200 
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To determine whether a new point on the graph has been estab- 
lished, the program checks to see whether the variable X has 
changed. If the variable X has changed, this tells the program that 
the graphics pixel has moved over horizontally and that a new point 
should be put into the array. To find the value for the point on the 
graph, you can use the simple formula 127 - (Y- 10) * 2. This puts 
the point into the array somewhere between 127 (when Y is at its 
low value of 10) and -127 (when Y is at its high value of 138) 
Notice that line 190 keeps the routine going until the program jumps 
to the routine that plays the sound. 

170IhOXOXTHENOX = X: LK(C) = 127 - (Y - 10) *2- 

LINE STEP (X, Y) 

190 GOTO 110 

200Uf*€0, UX 

210 SOUND 500, 20, 255, 0 

After the sound is played, the program erases the variables and the 
array W% before starting over at line 20. 

Now that you have a good idea of how to create a wide variety of 
AnTga'tal mUSiC ' ^ m ° Ve ° n 10 P™^ 2 ™ mak e the 



The Amiga Speaks 

The commands involved in making the Amiga speak are simpler than 
those used to create sounds and music. Only two commands are 
used: TRANSLATES and SAY. They are powerful and give the com- 
puter the capability to speak with tremendous flexibility. 

The first command, TRANSLATES, translates English statements into 
phonetics. If you have ever tried to do this yourself, you probably 
realize how fortunate programmers are to have this command built 
into the computer. Phonetics are alphanumeric codes that repre- 
sent basic parts of speech. For instance, the phonetic equivalent 
tor / am the Amiga computer is AY ARM DHIY AHMIYHGAH 
KUMPYUW3TER. Because people inexperienced in phonetics would 
have a hard time figuring this out, the TRANSLATES command can 
be extremely helpful. An added feature of TRANSLATES « th*t it 
takes into consideration question marks, exclamation points and 
other punctuation and adjusts the inflection appropriately 
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To make TRANSLATES translate English to phonetics, you use the 
following format: 

<string variable> = TRANSLATE$("<words>") 

If you wanted to store the sentence / am the Amiga computer in 
the variable BBS, you would type 

BBS = TRANSLATE$( "I am the Amiga computer") 

The variable BBS then would be equal to 

AY AEM DHIY AHMIY3GAH KUMPYUW3TER 

The resulting phonetic string, like any string, cannot be more than 
255 characters long. If you give TRANSLATES something that is too 
long to translate into a 255-character phonetic string, the screen 
displays an error message. The solution to this problem is to break 
up the sentence into several sections. 

You use the SAY command to make the Amiga say the string. SAY 
is much more powerful than TRANSLATES because you can use SAY 
to give the speech different qualities. These qualities are determined 
by numbers stored in an ?rray. The format for SAY is 

SAY (<string>) 

or 

SAY (<string>), <array> 
An example of the most basic way to make the Amiga speak follows: 

10 A$ = TRANSLATES ( " I am the Amiga computer") 
20 SAY (A$) 

This simple program makes the computer say the sentence. How- 
ever, if you know something about phonetics or simply want to try 
a different method, you can omit the TRANSLATES command and 
use your own phonetic string in a line. In fact, you could shorten 
the preceding program to 

10 SAY ( "AY AEM DHIY AHF1I Y3GAH KUMPYUU3TER" ) 

Using your own phonetic codes gives you the capability to fine-tune 
the speech so that it represents more closely what you want the 
computer to say. Although TRANSLATES works only with English, 
if you become experienced with phonemes, you can make the com- 
puter speak in almost any language. 
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Voice Changes 



If you want the computer to speak with its default characteristics, 
you do not have to use an array with the SAY command. However, 
if you do want to change the quality of the computer's speech, you 
can use an array with nine different elements. These are the elements 
for the HOW%( ) array: 

HOW%(0) The pitch for the voice, which can range 

from 65 to 320. The default is 1 10, but you 
can produce a squeaky voice by going up to 



HOW%(l) 



HOW%(2) 

HOW%(3) 
HOW%(4) 

HOW%(5) 
HOW%(6) 



The inflection value, which can be either 0 
for normal inflection or 1 for no inflection 
(monotone). The default is 1. 

The speaking rate, which can range from 40 
to 400. The default is 150, but you car* slow 
down or speed up the voice as you like. 

Male (0) or female (1). The default is male. 

Vocal quality, which can range from 5000 
(low) to 28000 (high). The default is 22000. 

Volume, which is the same as the sound and 
music volume. This can range from 0 to 64; 
the highest volume, 64, is the default. 

Channel, which determines which of the 4 
channels the computer speaks through. 
Channels 0 and 3 go to the left speaker, and 
channels 1 and 2 go to the right speaker. 
The default code is 10, which makes the 
computer talk through both speakers. You 
can determine what value to use by referring 
to the following codes: 

0 - Channel 0 

1 - Channel 1 

2 - Channel 2 

3 - Channel 3 

4 - Channels 0 and 1 

5 - Channels 0 and 2 

6 - uiannels 3 and 1 

7 - Channels 3 and 2 
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8 - Any left channel 

9 - Any right channel 

10 - Any pair of channels 

11 - Any single channel •' 

HOW%(7) A value of 0, which is the default, makes the 
program stop entirely until the computer 
finishes speaking. A value of 1 allows other 
statements to proceed while the computer is 
f] ■' talking. 

nTW%(8) This array determines whether the program 
should wait for any previous SAY statements 
to finish (0) or begin executing immediately, 
regardless of other SAY statements (2). If 
you wai^ the computer to stop talking, use a 
value of 1. The default value is 0, which 
makes the Amiga wait for other SAY 
statements to finish executing before it 
begins saying this particular sentence. 

The sample program that follows makes the Amiga say "I am the 
Amiga computer" through both speakers and then begins bouncing 
the sentence between the left and right channels. Although the 
values in the DATA statement in line 40 are the default values, you 
are going to modify HOW%(6) to change the channel through which 
the sentence is spoken. 

10CLS 

20 A$ = TRANSLATES ("I am the Amiga computer") 
30 FOR I = 0 T0 8 : READHOUXU): NEXT 
40 DATA 110, 0, 150, 0, 22200, 64, 10, 0, 0 
50 SAY (A$), HOIK 

60 IF H0UXC6) = 3 THEN H0UX(6) = 1 ELSE H0UX(6) = 3 
70 GOTO 50 

Use the preceding program as a basis for other short programs. By 
modifying several different elements of the SAY array and listening 
to the results, you will understand the significance of those elements 
better. Try typing a new line 60 and running the modified program, 
which selects a random pitch for the voice. 

60HOLK(0)=65 + RND»255 

Now type the following new line, which varies the rate at which 
the words are spoken 

60 H0UK(2) = 40 + RND * 360 
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The following line alters the vocal quality. 
60 HOK(4 ) = 5000 + RND* 23000 

Now, just for fun, use all these random elements at once and listen 
to the different ways (some of them are hilarious) in which the 
Amiga says tliis one sentence. / m 

10 CLS 

20 A$ = TRANSLATES ("I am the Amiga computer") 
30 FOR I = 0 TO 8 : READ WJ/J I ) ; NEXT - 
40 DATA 110, 0, 150, 0, irm, 64 30 0 0 
50SAY(A$), HOUJi 
60HOUX(0) = 65 + RND*255 
62 H0LK(2) = 40 + RND * 360 
64 H0U*(4) = 5000 + RND « 23000 
66H0ttf(6) = RND* 12 
70 GOTO 50 

To understand how the Amiga can "interrupt" words with the 
HOW%(7) and HOW%(8) elements, type DELETE 60 - 66 and add 
tne following lines to the preceding program: 

60HGttf(7) = 1 
65H0tK(8) =2 
67FORD=1TO500: NEXT 

A good project for you to do at this point is to create a program 
that lets you input all the different elements that SAY can use After 
the program receives the values from you, the computer could say 
a sentence that you also input. Writing such a program is not difficult 
and will help you understand even better how the TRANSLATE? and 
SAY commands work. 



The Amiga and the Handicapped 

Through Amiga BASIC programs, the Amiga can translate and speak 
what you type. This capability can be of enormous benefit for stroke 
victims the handicapped, and many throat surgery patients. Never 
before has this capability been so affordable for so many and this 
feature alone makes the Amiga the computer for at least 100 000 
people m the United States and approximately 500,000 worldwide 
Here is a simple program to illustrate this point: 
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10 INPUT "Uhat mould you like to say"; SN$ 
20 SAY (TRANSLATES (SN$)) 
30 GOTO 10 

Making sounds and music on the Amiga can be a lot of fun. In fact, 
making sounds is usually one of the best parts of writing any program 
because you can produce such an amazing spectrum of tones and 
speech. Now you have the knowledge that you need to add these 
elements to your programs. Sound and music can enhance the quality 
of just abou^ -uiy piece of software, especially an action-packed game 
or a sound ana ... ic development system. These features can make 
any of your programs fl^ch more enjoyable. 



6 

Learning Logo 



Many people regard Logo as a computer language "just for kids." 
When these people think of Logo, they visualize an eight-year-old 
moving a graphics turtle around the screen, Logo is indeed an easy 
language for children to learn. But TLC Logo for the Amiga can do 
much more than move pictures of turtles around the screen. 

John Allen, president of The Lisp Company (which wrote the Logo 
published by The Learning Company for the Amiga) believes that 
Logo has not been treated fairly by software publishers. Most versions 
of Logo, he contends, actually are subsets of the true Logo language 
and do not possess the computing power of real Logo. Fortunately, 
The Learning Company's Logo for the Amiga incorporates the fea- 
tures that are absent in most other versions of the language. In fact, 
those familiar with Logo regard it as one of the best languages avail- 
able for artificial intelligence programming on the Amiga. 

Although this book doesn't show you how to tap that kkid of power, 
you will see from the material in this chapter that in spite of Logo's 
simplicity, it is a useful language that both children and adults can 
learn to use quickly. (If you want to explore Logo's artificial intel- 
ligence capabilities, you will find the documentation that comes with 
the language an excellent resource.) 

Logo for the Amiga is not included when you buy your computer, 
but it is available at an extra cost directly from Commodore. Even 
if you don't own Logo at this point, examine this chapter to see the 
benefits and structure of the language. Perhaps you will be intrigued 
enough to buy a copy of Logo and learn it. 
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The simplicity of Logo, which makes it a good programming language 
even for elementary school children to learn, is evident in the lan- 
guage's commands. Simple command words usually bring immediate, 
visible results. For example, if you type FD 15 in the Logo language, 
a picture of a "turtle" moves forward 15 units on the screen. (The 
shape of the turtle actually is an arrow, but will be referred to as 
a turtle in this chapter.) For the beginning programmer, nothing 
could be easier to understand. In contrast, an assembly language 
statement such as MOVE.W tiNUMBERJX) 6 is cryptic, confusing, 
and doesn't produce any result that a programmer would notice 
immediately. 

Turtle Graphics 

Although the Logo language wasn't developed with a turtle in mind, 
that's what most people associate Logo with. The graphics turtle on 
the screen moves around at your command, drawing a line or some 
other shape along the way. Of course, you can use Logo for many 
other tasks besides drawing pictures. With Logo's mathematical and 
input/output commands, an integral part of the language, you can 
develop many other programming applications. For the most part, 
tills chapter explores graphics, but the material also touches on all 
the important Logo keywords you need to know in order to create 
some interesting and useful programs. 

Momng the Turtle 

After you load the Logo language into memory, you are ready to 
begin programming. The most fundamental programming operation 
you need to know is how to move the turtle. You can move the 
turtle most easily with the FD, BK, LT, and RT commands. These 
commands move the turtle forward, backward, left, and right, re- 
spectively. For example, to draw a square that is 50 units wide, you 
type the following: 

FD50 
RT90 
FD50 
RT90 
FD50 
RT90 
FD50 
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An alternate method for drawing a square of the same size uses two 
different commands: 

LT90 
BK50 
LT.90 
BK50 
LT90 
BK50 
LT90 
BK50 



Characteristics of the Turtle 

The turtle moving around the screen is named Studs, and he has 
certain properties when he first appears on the screen. First of all 
he has a name with which you can identify him -Studs. The name 
is useful because Amiga Logo, unlike most other versions of the 
language, can have more than one turtle on the screen at once Later 
in this chapter, you will learn how to use multiple turtles and how 
to give each of these turtles a name. For now, you will experiment 
with the first turtle, who for some reason was named Studs by pro- 
grammers at The Lisp Company. 

When Studs first appears on the screen, he is located at this position- 
(0,0). The turtle's position is described by this set of coordinates 
You can determine a turtle's position on the Amiga's screen by 
imagining a horizontal x-axis extending across the screen and a ver- 
tical y-axis extending up and down on the screen. The x- and y- 
axes intersect in the very middle of the screen, which means that 
there are four equal parts to the area where the turtle can move 
around. The position at the center of the screen, where Studs is 
located initially is (0,0). If Studs moves up near the top of the screen 
the value of his position on the y-axis increases; for instance if Studs' 
moves up 50 units from the center of the screen, his new position 
is (0,50). If Studs moves 100 units backward from that position his 
new position is (0,-50). On the other hand, if the turtle stari at 
(0,0) and moves to the left 25 units on the x-axis, he is at (-25 0) 
If Studs then moves 50 units to the right, he ends up at position 
(25,0). 

The directional commands that you use to move the turtle are all 

relative, not absolute. The destination of the turtle after an FD ur 



138 AMIGA PROGRAMMING GUIDE 



t 



BK command depends entirely on what direction he is pointed and 
what distance you tell him to go. 

When you first load Logo into memory, Studs has certain other char- 
acteristics. These characteristics, discussed next, are heading, visi- 
bility, pen state, turtle shape, tile shape, and ink color. 

JV->.- i t.V . 1 • • 



Heading 

At first, Studs is facing the top of the screen; if yon tell him to move 
forward, he moves upward. Studs' heading is measui ? in degrees- 
0 degrees means that Studs is facing the right side of the screen; 
90 degrees (the default) means that he is facing the top of the 
screen; 180 degrees means that he is facing the left side of the screen- 
and 270 degrees means that he is facing the bottom of the screen.' 
Essentially, the measurement in degrees begins on the rightmost 
point of an imaginary circle that surrounds Studs and continues 
counterclockwise to 359 degrees. Therefore, to point Studs down- 
ward and to the left, you could enter a heading of 225 degrees The 
command used to set a turtle's heading is HD, followed by the value 
of the degrees. For example, to make Studs point toward 225 de- 
grees, you would type 

HO 225 



Visibility 

When Studs first appears on the screen, you can see him. If you want 
a turtle to disappear so that the turtle still can draw but cannot be 
seen, you type 

TURTLE : HIDE 

If you want the turtle to reappear, you type 
TURTLE :SH0U 



Pen State 

You can move the turtle on the screen without having the turtle 
draw anything by using commands that change the pen state. If you 
hrt up the imaginary pen that the turtle is holding, the turtle 
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Sta^S* T CS InitiaUy ' SlUdS h ° Ids * C P en "down," ready 
to draw. To bring the pen up, you type Y 

PEN - UP 

Consequently, to bring the pen back down, you type 
PEN :DOUN 

If you want the pen to erase pixels instead of draw them, you type 
^FN - ERASE 

Notice thai *he words used in thesf rnmm,.^- , 

vou ^ flnd zu'zrtT^z^ 

Logo language are logical as well. gnout ™ c 

Shape of the Turtle 

If you would prefer to make the turtle a different shaoe than .he 

to ^geltSe^S, Y Z ^ ^ ~' 
SHAPE: AIRPLANE 

ffyon prefer to change the turtle back to the original arrow shape, 
SHAPE :ARR0U 

Tile Shape 

^ Tor e^^ ™ ~ 

TILE ; HEART 

To bring back the regular drawing line, type 
TILE - LINE 

Check your Logo manual for other amiable turtle and tile shape, 
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Ink Color 

You can change the color of the tiles with the INK command. To 
change the color of the line (or whatever tile you are using) to 
blue, you type 

INK : BLUE 

Keywords 

The beauty of the Logo language is that you can create your own 
keywords (user-defined words that you can use in programs). You 
are not restricted to words defined by the Logo interpreter. In ad- 
dition, you can save these keywords and use them later in order to 
make complicated tasks simpler. For example, you could use a com- 
mand as simple as DOIT or STARS or simply A to do something as 
complicated as draw three stars of different colors on the screen 
and create a triangle to connect them. 

To define a particular word, you use the TO command. Suppose 
that you want to store a routine that draws a square in a user-defined 
keyword called MYBOX. You would type 

TO MYBOX 

FD50 

RT90 

FD50 

RT90 

FD50 

RT90 

FD50 

END 

Now every time you type MYBOX md press the RETURN key, a box 
with a width of 50 is drawn. 

Once you begin to define your own words, you can build on them. 
For instance, now that you have defined MYBOX, you can create a 
routine called FOURBOX, which draws a set of four squares: 

T0F0URB0X 
MYBOX 
MYBOX 
MYBOX 

MYBOX 
END 
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To repeat a command, you don't have to type the same words over 
and over again. In feet, Logo has some powerful commands, such 
as REPEAT, which makes the above definition as easy as this: 
TO FOURBOX 
REPEAT 4 CMYBOX] 
END 

Remember that when you define your own commands, you cannot 
use "reserved" words. That is, you cannot use the TO command in 
conjunction with words that Logo already uses for some particular 
junction. For eiu^ple, TO ID or TO ASK would create an error 
because FD and ASK are Logo primitives, words that the language 
has stored to do certain tasks. 

Using Variables with Keywords 

You easily can take TO a step further by using a variable in con- 
junction with the new keyword. Remember that a variable represents 
a number stored in memory. Logo recognizes variables that are pre- 
ceded with a colon (:). For example, suppose that you want to write 
a program that draws a square of a certain size. You can store \h~ 
length of each side of the square in a variable called :SIDE. 

To program a keyword that supports a variable, you need to type 
7D followed by a keyword and then the variable or variables To 
define a keyword that draws a square, you type 

TO PROGSQAR 'SIDE 
REPEAT 4 CFD SIDE RT 90] 
END 

Note that the END command signifies the end of a routine Also 
notice that the variable SIDE always must have a colon in front of 

pVA^J 0 bC imerprCted 35 a numeric val "e. When you use the 
rKOGSQAR routine, all you have to type is PROGSQAR followed by 
a number. For instance, typing PROGSQAR 20 results in a square 
20 units wide being drawn on the screen. 



Using Multiple Variables 
with Keywords 

You can use more than one variable with a keyword definition as 
long as you account for each variable when you set up the keyword. 
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To illustrate, define a new word called MAKE RE Cr, which creates 
a rectangle with the width and height that you specify Call the width 
and height :WID and :HIT, respectively. Program the routine as 

follows: 

TO MAKERECT =UID : HIT 

FD =HIT 

RT90 

FD = UID 

RT90 

F3 •HIT 

R" ^ 

FD ■lilu 

END 

Once the keyword is define^, you can draw a rectangle of any di- 
mensions. For example, to draw a rectangle that is 20 units wide 
and 40 units high, you type 

MAKERECT 20 40 

As you continue to build your own keyword library, achieving results 
becomes easier. The most valuable aspect of defining your own key- 
words is that you can use those keywords to build more keywords, 
which in turn can be used to build more keywords In time, with 
your keyword library, you will be able to produce complex results 
by using only one or two sophisticated commands. 

Controlling the Turtle 

Because FD, BK, LT, and RT are your "workhorses" for drawing, take 
a closer look at what these commands can do. To tell the turtle to 
go forward or backward a certain number of units, you specify FD 
or BK followed by the number of pixels that the turtle should move. 
For example, FD 34 makes the turtle move forward 34 units in 
whichever direction it is facing. LT and RT turn the turtle a certain 
number of degrees left or right. A full circle equals 360 degrees. 
Therefore, to get the turtle to do an "about face," you simply type 
RT 180 or LT 180. 

The short program that follows uses these commands to draw a 
triangle. 



TO TRIANGLE 

RT45 

FD100 

LT90 

BK100 

RT315 

FD 140 

END .. 
Although FD BK, LT r! p 

of the time to move ^turtl^V"* 7 ° U ^ use <*°* 
^ other commands a« ^ ^ ^ can use 

purpose. For instance, F, B lJrIT accomplish the same 
number of pixels, 

grees, and right 45 deeree, r f nUmber of P*els, left * 5 de 
"certain numfer ^JKJ'J? ^ d ~ e ^ 
* e f and B commands by I'lTh ^ ** en >™ 
pixels) by 4. Therefore if theTr. ^ ^ ° f the s «een Cin 
-and moves the turtle ^ ^ B - 

Because the values of the FBI anw » 
commands don't provide as mucl ^1^^ m ^ 
However, they are useful when von S ^ ^ BK - LT > RT 
rollowing short program "s^thT^ T * 0ie &ed ^ues 
the turtle draw a trianglfZte rh, ^ co ^ds to make 
be on a line. ^ N ° te ^ mo ^ than one command can 



RF 
RRF 
RRRF 



You didn't use the Tn 

*«P« lust foUo~co^f T 3 W ° rd ** ** 

"*"* WOuld * to progL, f ,0 
S, E, and W are four mh«. r 

a particular directio W^TT * *« make Studs move 

^ S ^ points ToC (tuty N 
"ght (east); and W always nniZ l*'™ 1 * E always points to the 
«TM X^a^ * C 'eft (west). These co™ 
«"le is facing, but ta0 7° U a ^ n « sure which direction the 
one of these four ^Z^o^T *•* * move L 
*«e commands ,„ makc „ a^ e °£f ^.""f- ™" «>"'<< 
N16E16S16LMA C mat 15 1<5 P«els wide: 



144 AMIGA PROGRAMMING GUIDE 



When you write graphics programs, you will want to work with a 
"clean slate." To clear the screen of all text and graphics, you can 
use the CS command This command erases the contents of the 
screen, yet leaves the turtle in its current position and heading. 

To draw sophisticated graphics, you need to have a lot of control 
over where the drawing arrow is and what it does. The PCS com- 
mand lets you specify at exactly what (X,Y) coordinate you would 
like the turtle to be. With this command, you can draw graphics at 
a specified location and move *he turtle around the screen with 
ease. To use POS, follow the comma,.; -iu. the X and Y coordinates, 
in brackets, which specify where you warn "he turtle to be. If you 
want to move the turtle to position (-50,20), for instance, you type 

POS C-50 30D 

If you want to send the turtle back to its original position and face 
the turtle north, you use the HOME command by itself. 

Directional Settings 

An excellent way to control the turtle is to set its direction. You 
can icll the turtle at what angle to point by typing HD followed by 
the number of degrees. However, you often will find in graphics 
programming that you need to point the turtle somewhere, but you 
aren't sure what the angle should be. For instance, a turtle may be 
in a random location, and you want to point it directly to the middle 
of the screen. The FACE command will solve this problem. You can 
use FACE to point the current turtle toward a certain point by using 
FACE followed by the (X,Y) coordinates in brackets that specify 
where you want the turtle to face. Or you can use FACE to point 
to another turtle by using FACE followed by the name of another 
turtle. 

For instance, if you don't know what relation the turtle is to the 
middle of the screen, you can type 

FACE [0 0] 

to point the turtle toward the middle of the screen. If you want to 
point the turtle toward the coordinate (30,-65), you type 



FACE C30, -65] 
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likewise, if you want to point the current turtle, Studs, toward an- 
other turtle named Mack, you type 
FACE :MACK 

^r^ 0 ^ " ^"^nsional figure without posing too 
much difficulty for the programmer in the program that follows 
TOPERS 
CS 

PEN :UP 
FD70 
LT90 
FD70 
PEN :DOUN 

REPEAT 4 CFD 50 RT 903 

FACE C0 03 

FD90 

FACE C-70 1203 

FD130 

PEN :UP 

POS C-120 703 

PEN :DOUN 

FACE C0 03 

FD134 

PEN UP 

POS C-120 1203 

PEN ^DOUN 

FACE C0 03 

FD150 

END 

you want to draw only one dot on the screen (as opposed to a 

f^T T COmmand ™" ~ d KS * 
orawmg stars, forming the eyes on a figure, or plotting the points 

of a graph. You should use DOT by itself to draw a dot £ the .££ 

SET™ *t e f sure ** 1116 mrtie,s pen is positio - d « 

wncrc you want it before you use DOT. 

To position the pen exactly where you want it, you can use the POS 

XttT ' S 10 « ^° onTr^anl 

^^^T^^ These are the X and Y 



146 



AMIGA PROGRAMMING GUIDE 



Special Symbols 

Certain symbols used in Logo have special meanings. These are the 
question mark (?), the semicolon (;), and the colon (:). This section 
looks at each of these in turn. 

Here is a very important rule of Logo: If a command that you can 

give absolute values to is followed by a question mark, the computer 

displays the current status of that command's functioa Examples of 

such commands are X, Y, POS, HD, but not FD, BK, LT, and RT; the ; 'f 

latter commands are relative, not absolute values. For instance, if 

you type POS [50 50], the computer puts the turtle at location 

(50,50). If you type POS ?, however, the computer interprets this 

to mean "tell me what the current position of the turtle is," and 

the computer responds by displaying the position of the turtle. 

Another helpful symbol is the semicolon (;), which is used in Logo 
for comments. Therefore, anything following a semicolon is ignored 
by the computer. "Here are some examples that demonstrate both 
the use of the question mark and the semicolon. Assume that Logo 
has just been loaded and that the turtle is at position (0,0) facing 
north. Notice that when the X or Y command is followed by a num- 
ber, the computer changes the turtle's position to that new location. 

POS?; display the position 
□3 01 

FD 10; go up 10pixels 

[0 10: 

RT90BK20; turn right 90 degrees and go backward 20 pixels 
POS ? 
C-20 10] 

X ? Y ? ; what are the current X and Y values? 

-20 

10 

X10Y20J set the new turtle position to (10,20) 
POS ? 
[10 203 

Aside from the question mark and semicolon, the colon (:) also is 

a very important special UuuaclCl. TIil colon indicates Oiai a VaitaDle 

is being used. Here is a simple rule to follow: 
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No colon means this is an action. 
Colon means this is a value represented by a variable. 

You can use the question mark with the INK command to find out 
the current color being used to draw with, you type 

HK? 

The computer responds by printing the name of the current color 
being used. 

■ You also can use the INK command with a colon and the name of 

a color to indicate a color that you want to use. H? example, to 
use blue, you type 

INK :BLUE 

You can change the background color with the PAPER command. 
If you follow PAPER with a question mark, the computer tells you 
the current background color. If you follow PAPER with a colon 
and a color (for instance, :WHITE, rBLACK, or :BLUE), the computer 
changes the background color to the one you specify. 

You already have seen how the colon is used when you set up Logo 
keywords. You also can use the colon, for example, if you want to 
write a routine that gives you the square of a particular number: 

TOSQR :NUT1 
:NUM* :NUM 
END 

Because it is preceded by a colon, :NUM is known to be a variable. 
When you use the SQR primitive, you type SQR followed by the 
number you want squared. The Amiga then prints out the square 
of the number. 



The Screen's Boundaries 

The screen is limited in size and, unless specified otherwise, the 
turtle may travel off the screen. You can control the movement of 
the turtle at the screen's boundaries with the TM command. Three 
different numbers can follow TM: 

TM :0 The turtle can move beyond the boundaries of the 
screen. The screen acts as a window of a much 
larger size— 64000 by 64000 pixels When the 
turtle moves outside the boundaries of the 
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physical screen, you can no longer see it; if you 
move it back into the screen area, the turtle is 
visible again. 



TM :2 



TM :1 




You can control the nature of the screen itseu ^iih the GS, SS, and 
TS commands. 



Turns your screen completely into graphics mode 
so that no text can appear on the screen. Use this 
command when you are going to be drawing 
graphics only. 

Splits the screen so that a small part of the bottom 
of the display can be used for text while most of 
the screen can be used for graphics. 

Makes the screen work with text only. If you try 
to draw any graphics, you get a Non-Graphics Mode 
error. 



Multiple Turtles 

As mentioned earlier, you can have more than one turtle on the 
screen at one time, and you can control each turtle individually To 
create a new turtle, type HATCH followed by a double quotation 
mark (") and the name of the turtle. For instance, to make another 
turtle, named Mark, appear on the screen, you type 

HATCH "MARK 

Now you have two turtles on the screen-Studs and Mark But just 
because you hatch a turtle doesn't mean that the new turtle will 
pay attention to you. You need to decide which turtle you want to 
be active and tell that turtle to follow your commands. To activate 
a turtle, use the ASK command followed by the name of the turtle. 
If you want to get Mark's attention, type 
A3K -rtwc 
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After you type this command, all of your commands are sent to Mark, 
not Studs. You also can change the name of a turtle by using the 
ID command followed by the new name that you want. If Mark is 
the active turtle, you could change Mark's name to Tom by typing 
ID "TQM 

As usual, you can find out the property stored in this command by 
typing ZD ?, which tells you the name of the active turtle. You can 
find out the names of all the turtles by typing IF and pressing the 
RETURN key. 

Fundamental Programming 
Commands 

Many keywords in Logo make progi-amming easier and more effi- 
cient. Among these are REPEAT and FOR, DELAY, RC and RL, PRINT 
and its variations, PT, and HELP The sections that follow discuss 
each of these commands in turn. 

The REPEAT and FOR Commands 

You can use the REPEAT command (mentioned earlier in the chap- 
ter) to reduce the number of prograrnming lines you have to type 
With this command, you can tell the computer to do the same op- 
eration a certain number of times. The format is 

REPEAT <number> <action> 

The number specifies how many times you want the operation per- 
formed, and the action is the operation itself. For example, to draw 
a square using only simple commands, you could type 

TO SQUARE 

FD50 

RT 90 

FD50 

RT90 

FD50 

RT90 

FD50 

END 
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Or, you could make life much easier by typing 
REPEAT 4 EFD 50 RT 903 

The more times you repeat a series of commands, the more useful 
REPEAT becomes. 

When you use the REPEAT command, you must enclose within 
brackets whatever is to be repeated. Precede the brackets by the 
number of times that you want the action performed. For instance, 
if you want the turtle to rotate 45 degrees to the left for a total of 
5 times, you type 

REPEAT 5 CU 

A different version of the REPEAT command -FOR- is very similar 
to the FOR... NEXT commands in Amiga BASIC. The FOR command 
is followed by a variable name, the number you want to start with, 
the timber you want to end with, and the commands you want 
acted on wiiiie the loop is executing. For instance, to make the turtle 
go forward 10 units and turn right 15 degrees for a total of 5 times 
you could type 

FOR "TIMESi5CFD10RT15: 

Notice that the computer counts from 1 to 5 and stores the number 
that it is counting within the variable TIMES. Moreover, everything 
enclosed in brackets is repeated these five times. 

The last routine could be accomplished just as easily with REPEAT 
In the next program, however, FOR is clearly a more effective com- 
mand than REPEAT for the routine. 

TO SQARMAKR ^NUMONE NUrlTUO 

PRINTSE ' This will show the sguare roots of the numbers in the 
range you specify' 

FOR "COUNT :NUM0NE ^NUrfTUO CPRINT : COUNT PRINT SORT ■COUNT] 
END 

When you use this routine, you type SQARMAKR followed by a low 
number and a high number that define the range of integers whose 
square roots you want to know. If you type 

SQARMAKR 10 15 

the computer displays the numbers 10 through 15 along with their 
square roots. Moreover, all that is enclosed in brackets is subject to 
the loop that goes from :NUMONE to :NUMTWO. This loop allows 
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etie^tocTe^^ "* ^ rout " e <™<* 

7Zk? Z)£L4r Command 

t^^Z C ° f mnUnd J"*"" ^ a numb « 1^ represents how 

fcT ins.^ ^ W!U " * e **■ to P ause - Y °" "light 
do this, for instance, in order to show a picture on the screen for 

seconT a '" OUat ° f time - T ° St ° P * e com P uter «* a tSal ol W 
™t>pe ^ ° n "* ^ C — ta - Procedure' 



DELAY 100 



The RC and RL Commands 

You have looked at the commands that make Logo do specific tasks 
Now you will explore the way in which Logo fets iSjS 
user. (A program that doesn't interact with thl ZT^ 
almost useless.) The AnHea's i™^ ^. P e,s on usmg it is 

fnmwt . . J , c ^^gas Logo has two commands that eet in 
formation Erectly from the keyboard: RC and RL * 



RC 
A 



then nress RmiT, Sttu * For exam P^, if you type 



RL 

Hi ther e 
'Hi there' 
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The PRINT Commands 

To display something on the screen without accepting any input 
from the user, you can use variations of the PRINT commands. Use 
PRINT to display numbers and PRINTSE to display full sentences. 
PRINTNL has the same result as PRINT, except that each number 
is followed by a line feed. Here are some examples of these 
commands: 

PRINT 10 PRINT 20 PRINT 30; notice on the next 1 i ne that there are 
no line feeds; even the Question mark prompt is not forced to the 
n^t line 

**23 30? ''PRINTNL 10 20 30 

10 

20 

30 

PRINTSE' This is a test of ths emergency broadcasting system. ' 
This is a test of the emergency broadcasting system. 

PRINTSE CI 23 4 5' Hell o'D 
12345'Hello' 



The PT Command 

At times, you may want to examine the first line of a particular 
function in order to remind yourself what a certain word does. You 
may even want to make a habit of putting a comment on the first 
line of each procedure that you create. These comments can be easy 
references for finding out what a certain procedure does. The com- 
mand that displays the first line of a function is PT. For a demon- 
stration of how this command works, enter the following short 
routine. ° 

TO GREETINGS 

CS; This routine clears the screen and welcomes the user 
PRINTSE 'Welcome to the Amiga Computer. This is the Logo 
Language. " 
END 

Now issue the PT command as follows: 

PT GREETINGS 

The Amiga should display 

C3; Tfiis routine clears the screen and welcomes the user 
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With FT, followed by the routine you want to check, you can quickly 
find out what a certain routine does as long as you have entered a 
comment on the first line of the routine. 

The HELP Command ; 

If you need information about one of the computer's keywords, other 
dian one of your own, type HELP followed by the word you want 

vof mthfn 5 ™ ^ S7Steffi * ^ >™ * of Leto 
you nught have spent looki through documentation. Here is an 
example of how you could use ttus -ommand: 
HELP "HD 

The Heading (In Degrees) Of The Current Turtle. 

File Management Commands 

Some commands are not meant to be used in programs because they 
sunply help manage the files on your Logo dislfTrh these corn" 

™ nf",^ *Z keyWOfdS «* r ° UtineS ' load m ™> ^ew a di- 
rectory of all your files or of particular ones, and erase files. 

Saving Files 

Once you have defined a word, you may want to save it for later 

n^d^^ 

SAUE' SPIRAL' 

TTiis saves SPIRAL for the future so you don't have to type it again 
Later, when you want to load the word, you type 
LOAD' SPIRAL' 



Displaying the Directory 

After you have stored a number of routines on a diskette, you may 
have trouble remembering the names of every one of your routing 
You can chsplay a list of all the files on a diskette by typing 

riTn - .., 
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or you can specify certain types of files by entering within single 
quotation marks the criteria for the search. For instance, to view all 
the files on the disk that have a GRP extension (such as CIRCLE.GRP, 
SQRGRP, and SPIRALGRP), you type 

DIR'. GRP 

and something similar to the following would be displayed: 
[CIRCLE, GRP SQR. GRP 3PIRf=*_. GRP] 

You also can specify that the names of certain files be displayed by 
using a wild <^aru. Tf you use the question mark as a wild card, any 
character in the t *tios held by the question mark will be allowed. 
If you use the asterisk af a wild card, up to eight characters in a 
row in the position held by the asterisk will be allowed This explains 
why DIR' *' displays all the files on the d*sk Here are some more 
examples; 

If you want to display all files that begin with the letter P, you can 
type 

DIR'P*' 

If you want to display the files that begin with AT, you c-«n type 
DIR' AT»' 

And, if you want to see the names of the files and words you have 
stored that are three letters long and the third letter is an X, you 
would type 

DIR'??* 

Remember that the period (.) separates the first part of the name 
from the extension (the second part of the name). If you don't 
include the period as part of your criteria, the computer will ex- 
amine only the first part of the name. A DIR' TTX' command, there- 
fore, would display names like LEX. 123 and XXX.HI. 

Erasing Files 

To erase a particular file or routine that is stored on the diskette, 
you type ERA followed by the name of the file enclosed in single 
quotes. You can use the wild card system to eliminate more than 
one file at a time. (These conventions will be familiar to CP/M® 
users.) Here are a couple of examples: 
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ERA 'LEX. 123- . this erases the fi le cal led LEX. 123 
ERA ' S*" ; this erases all files that begin with the letter S 

Text Commands 

Even though Logo is regarded by most people as a graphics language 
it also has commands that deal with text. is fortunate because' 
a truly useful program interacts with the utt through text 



You already have seen how the PRINT, PRINTNL, ana ?*CVTSE text 
commands work (see "The PRINT Commands" section in this chap- 
ter). Another way to work with text strings is to change them from 
uppercase to lowercase or vice versa with the LOWER and UPPER 
commands. For instance, if you follow the LOWER command with 
a string, every character in that string becomes lowercase. 
' Some of these LETTERS are UPPERCASE' 
some of these letters are uppercase 

Conversely, the UPPER command changes all the characters to 
uppercase, 

UPPER 'make these letters BIG Amiga'' 
MAKE THESE LETTERS BIG, AMIGA! 

Before you move on to the next text command, you should take a 
minute to review the ASCII system. You may remember that ASCII 
is the computer's set of characters that correspond to keyboard let- 

0^55^ V ^K 01 " ^ ASCI1 CharaCter « fr om 0 

to 255 and each number represents a specific letter, number or 

symbol. For example, the ASCII character 65 on any computer is 
the letter A (consequently, ASCII 66 is B). 

The next text command, CH, is a character conversion command 

. H ^ ASC ^ CHR$ COmmands ta BASIC. ^ 

lowmg the CH command with an alphanumeric character, you can 
find out what the ASCII code is for that character. For instance ^ 
find out what the ASCII code is for the letter F you type 



CH"F 

and the computer displays 
70 
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Using CH with an ASCII code displays the character that corresponds 
to the number that you input. CH with an ASCII code performs 
exactly the same function as the CHR$( number) command in Amiga 
BASIC Because the ASCII character set is the same for all computers, 
CH 65 on your Amiga will produce an A, just as it would on any 
other computer equipped with Logo. The routine that follows, which 
is stored in the word CHRS, prints out the entire set of characters 
available on the Amiga by listing ASCII characters 0 through 255. 

TO CHRS 

FOR "COUNT 1 255 CCH ■COJtfn 
END 



Elements and Objects 

You may have noticed that Logo often uses brackets ([ and ]) wiih 
keywords. An important use of brackets is to set up groups of in- 
formation called objects. Objects can contain additional information, 
also enclosed in brackets. Within an object, each number, character, 
or symbol is called an element. 

You can use objects directly with commands, or you can store ob- 
jects in variables. To demonstrate how you can use keywords to 
modify and extract information from objects, set up a hypothetical 
group of information that looks like this: 

C12345ABCDE] 

Now use the MAKE command to store the object in the variable 
TESTER You type MAKE followed by the variable name and the 
object. 

MAKE "TESTER C12345ABCDE3 

C12345ABCDE: 

: TESTER 

C12345ABCDE3 

Notice that Logo displays the object after you define it. Why? Because 
you typed a colon before the object name. 

To find out how many elements an object contains, you use the 
LENGTH command. For example, if you type 

LENGTH : TESTER 
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the screen displays 10 because the object has 10 elements Note- If 
an object contains additional objects, Logo counts tho^L 
as only one element. Here is an example: ' 
LENGTH CI 2 3 C4 53 1 



4 



Hie object has only four elements. COS] is considered one element 

™Z Z ^ W many ° f "* *"* character, in an ob/ect 
™< to « «* NEWSTR command. This commas stS 

number ° f ««- m » 



MWTEST2NBJSTR9'r 

' $$$$$$$ $r 



N^STR9'$- tells Logo to put nine dollar signs within the TEST2 



BF'GLOUE' 
'LOVE' 

BFa0987654321] 
C9876543213 

BF : TESTER 
C2345ABCDEI1 



BL'HIT' 
HI 

BL : TESTER 
C12345ABCD3 



The opposites of the BF and BL commands are the FIRST and r aqt 
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FIRST 'This is a test' 
T 

FIRST : TESTER 

i 

LAST ' This is a test' 

t • *. , 

- 

LAST : TESTER pp&m s 

E « - 

LAST CI 2 3 C' Hi there' 11 
' Hi there' 

You can extract an element that is not at the beginning or end of 
an object with the NTH command. NTH represents the "Nth" ele- 
ment in an object. You type NTH, the object you are working with, 
and the number of the element you want returned. For instance, to 
extract the sixth element of : TESTER, you type 

NTH : TESTER 6 

Logo rer^ms the letter A More examples follow. 

NTH CI 23 M 56 711 4 
C4 5 6 71 

TH CI 2 3 C4 5 6 711 2 
2 



NTH ' Uhi ch character do you want?" 5 
'h' 

The last two commands you should know when working with ob- 
jects are FPUT and LPUT. FPUT adds whatever you specify to the 
beginning of a string or object; LPUT adds whatever you specify to 
the end. For example, suppose that you want to add the letters 
X Y Z to TESTER You could type 

FPUT"XYZ ■ TESTER 
and the result would be 
CXYZ12345ABCDE3 

To add 'The End' to the end of TESTER, you could type 
LPUT ' The End' : TESTER 
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and the result would be 
CXYZ12345ABCDE'The End': 



Mathematical Functions 

Logo supports a number of mathematical functions, simple ones as 
weU as complex ones. The fundamental spools that perform the 
Wtons hsted in table 6.1 are + , , - and /. ^ mb f e Ascribe! 

is sL n giVCS md CXample ° f each " q^on mark 
^ 7 y &u r Prompt to type something). 



Table 6.1 
Logo's Mathematical Functions 

Format Description Example 

number + number Displays the sum of ? 4 + i0 

numbers 14 

number - number Displays the difference ? 50 - 33. 5 

between numbers 19. 5 

number * number Displays the quotient of ? 5 * 6 

numbers 30 
numberl / Displa the resu|t 

number2 divided by n2 2 0 

n1An2 Displays the result of n1 74*3 

raised to the n2 power 64 



S mGmTim T^° S / nathema,ical actons to modify a num . 
dct. «t(, and INT. To make a number negative vou use rb, mc- 
nmction When yon precede any nnmber S 
makes ma. number negative, regardless of ^emer^t^sWve 
or negauve to begin with You use INT positive 
anything that f o„o^ the 

amples of NEG and INT: ^""cr. nere are ex- 



NEG10 
-10 

NEG -20 
-20 
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INT 5. 323215 
5 

INT -50 
-50 



Three more useful functions are SQRT, REM, and RN The SORT 
function, as you might guess, calculates the square root of a number c r 

^ REM finds the remainder of two numbers when the first is divided 86 ?n 6 " u 

by the second And RN selects a random number between 0 and a s the bfeirifi ,> 
number you specify (which can't be more than 32,767). Examples 
of these functions follow. 



SORT PI 
3772454 

SORT 81 
9 

RBI 10 3 
1 

REM 9 3 
0 

RN 1000 
532 



When you work with trigonometry or other programs that require 
the number pi (which is about 3. Hi 5926538979), you can use 
Logo's built-in PI You use PI just as you would an ordinary numb^ 
as shown in the first of the previous examples (SORT PI). 

Logo has many other trigonometric functions, all of which you use 
m the same way: you type the name of the function followed by the 
number you want to work with. Table 6.2 lists Logo's trigonometric 
functions and gives a description of each. 



Efts m 



Decision-Making Commands 

The "heart" of any computer language is in its capability to make 
dects.ons based on certain conditions Logo has many more decision- 
making commands rh™ A^ig, n^c, TOcrefo ^ u cajl 
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Table 6.2 « 
Trigonometric Functions 

Function Description 

COS Finds the cosine of a number 

Computes .the tangent of an angle 

Computes the base-10 logarithm of a number 
Computes the natura. (base-e) logarithm of a 



TAN 
ATAN 

LOG 
LN 



EXP 



Raises the natural number e (2.718282) to the 
power you specify ' h 



-*S5£«5; S. c -* - — — — 

these and omerlecSon m Zo k J" 1 * °" e ano(h « Y °« « 

one or bo* of whS TZ ^Tf, T* *° C ° mpare «"° 

with either a Tru^o^ F L ™ ™ ""^ res P ond * 



•NUMK100 
False 



you can use decision-making symbols ^ WayS 11131 

111 > n2 ° U * uts T ' ue ^ nl is greater than n2 

nl< " 2 ° ut P u * True if nl is less than n2 
nl - n2 Outputs True if nl equsk n2 

DI ^ n2 ° U * u£s ^ue ^ nl does not equal n2 
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nl >= n2 Outputs True if nl is greater than or equal to 
n2 

nl <= n2 Outputs True if nl is less than or equal to n2 

Several Logo functions make decisions about numbers only. Here 
are some short explanations and examples of these functions which 
are all similar. 

j I .:. , . 

EQ Compares two numbers, objects, or any other 

comparable items 

EQ 10 10 
T^ue 

EQ "ABCD "ARCD 
True 

EQCABCDD 
False 

EQ :NUm =NUr11 
True 

MAX Compares two numbers and displays the larger 
of the two. This feature saves you time; you 
don't have to go through the more complicated 
process of comparing two numbers and 
programming Logo to decide which is larger. 

MAX 10 20 
20 

MAX 512 :NUM2; assume NUM2 equals 200 
512 

MIN Determines and prints the smaller of two 

numbers. MIN is the opposite of MAX. 

MIN 10 20 
10 



MIN512=NUM3 ; assume NUM3 eguals 400 
400 
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MINUSP Determines whether a number is less than zqro 

MINUSP 10 
False 



w 2-. 



MINLSP -5 
True -h;, 

2EROP Determines whether a number is equal to 2ero 
ZEROP 0 
True 

ZEROP 2 
False 

You also can use Logo's decision-making statements to check objects 
for certain conditions. For example, you can use the MEMBER com- 
mand to see whether an object contains a specific element You 
specify the element that you are searching for, then the object or 
s ring that you are searching within. If the object does contain the 
element, Logo returns the element's position; for instance if the 
element is the fourth one in the object, the screen displays the num- 
ber 4. If the object does not contain the element, Logo returns Fal se 
Here are some examples: 

MEMBER "B CA B CI 
2 

MEMBER "s ' Testing' 
3 

MEMBER "P ' Hottub' 
False 

MEMBER CX Y 21 CI 2 3 CX Y 21 ABC] 
4 

In the last example, 1, 2, and 3 are the first three elements, and the 
subobject fx YZ] is the fourth, fx YZj is an element in itself because^ 
it is enclosed in brackets. 

You can use the ISEMPTY command check to see whether an object 
or part of an object is empty. Here are some examples: 
I3Q1TTV ' ' 
True 
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ISEMPTY' I AM NOT EMPTY!' 
False 

ISEMPTY FIRST CC 1 A B CD ; note that the subob ject i s empty 
True 

ISEMPTY NTH CI 2 3 C ] 5 6] 4 ; note the 4th element is empty 
True 

Logo's decision-makers also enable you to check the values of certain 
commands, such as .HEADING, INK, and TURTLE. For example, to 
check the color of the _ ■'- currently being used, you type 

(INK?)=:BLUE 

Logo responds True if the ink is blue; False, if the ink is any other 
color. The command and question mark, which must be enclosed 
in parentheses, ask "what is the current ink color?," and = = BLUE asks 
"is that color equal to blue?" 

You can use ALL, a powerful decision-making command, to test the 
truth of two or more expressions in a single statement. The expres- 
sions that follow the command must be enclosed in brackets. If ail 
the expressions are true, Logo outputs True. If one or more of the 
expressions is false, Logo returns False. Some examples follow. 

ALL C2<10 12>7 3=3 5>33 
True 

ALLC2>1012>7 3=6] 
False 

The ANY statement, another kind of logical test, is similar to ALL 
If any expression following ANY is true, Logo returns a True. If all 
the expressions are false, Logo returns a False. Here are some 
examples: 

ANY C3=2 4>5 8=7 76<773 
True 

ANYC3=3 4=4 76>1] 
True 

ANYC4=2 5=7 10<=13 
False 



IFFALSE CO^l Tl 1 C ° nd,tl0n 15 M ^ ^ IF ^UE and 
two pos^bi~mt W ^ 8 ° l0giCaJ dccisions based on 

you Le just ^Xo^tSLse^o 311 ^ *« 
come, whether it is true orT^^^J^ ^ ** ° D *" ° Ut " 

**> *- not ^r^rs^ r or 

The foUowing program demonstrates the use of the IFTRITF 
I^AISE commands. If the value of the last testis f md 
whatever action is specified in Vu I ^ P er ft*ms 

command. If the re s r^^ ^ ** IFTRiJE 

and its contents ^'SSr^^^ 
perform the action speeded in^ck™ 1Wte ^° 

If the result is true however iT? J teSt fesult is 
Here is an example ' 8 ^ t0 1116 next co ™and line. 



T0DED1AKER 
HAKE "RANNUtf RN1000 
■RANNUrl>500 



m rKICTSE The random numbar is U 5s thanor e ,ual toSOr : 

-^hett Sr^iT^^ ^ ° and 1,000 
number is gr^ te — Z^' h *? 50 °- ff 

mand appears. Otherwise the scre e T* , T 8 ,mtUE com - 
IFFAKE command d,SpIays messa ge after the 



Logo's Possibilities 



should ge, a S* oTloS^ee^ Z T""* You 
explore artificial tateffigTce forl^ * y °" to 

ing Company Logo fofthe ^^1X1^ ?* kar °- 
sub,ect In addition, learning i^f ™ ™ C J ""reduction to the 
computing horizons, to before n mfl^T '° ^ > ou * 
'-guages, and to enhance your ^cTtSnT C ° m <> Uto 
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7 

Programming in C 



The C programming language is the premier language for software 
development on microcomputers. Introduced by Bell Laboratories 
more than a decade ago, C continues to gain popularity in the pro- 
gramming world. 

The reasons for Cs popularity are many. Principal among thtse is 
the power that C provides for the programmer. The language's wide 
variety of operators and functions give the programmer access to 
the very "heart" of the computer. This power is harnessed by the 
functions, which are the building blocks of C programs. A C function 
is a self-contained program unit that performs some useful task. For 
example, C contains built-in functions for input and output. A pro- 
grammer also can create building blocks of functions that can be 
used in many C programs. Once these blocks are designed and de- 
bugged, a function library can be built that speeds the process of 
programming considerably. 

Speed in processing is a second reason for C's popularity: Aside from 
assembly code (which is difficult to program with), C is generally 
the fastest language available on microcomputers. 

Languages like Amiga BASIC and Logo are interpreted languages. As 
the name implies, interpreted languages take a line of code and 
interpret that line each time it is needed. The fact that this inter- 
pretation, or translation, takes time explains the slowness of BASIC 
and Logo. C, on the other hand, is a compiled language. A compiled 
language creates (by means of a compiler) object code for the 68000 
microprocessor, which is used in the Amiga. Although this one-time 
translation from C to Amiea mav take some time, after this initial 
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effort, the program produced is always fester than a similar inter- 
preted program. 

The third reason for Cs popularity is the widespread availability of 
the C language for a variety of machines. Unlike Applesoft BASIC 
TRS-80 BASIC, and Microsoft BASIC®, which are all limited to spe- 
cific computer lines, C is a fairly portable language. This portability • - 
is useful if you are writing programs for sale and desire a larger £k - 
audience for your creations. . ; •-, i - jCV ' 

This chapter gives you only a taste of the power of *he C language 
You will learn about the compilation process, in genera rms, 2* 
how C is different from languages like Logo and Amiga BASIC 1". 
you will be taken through the steps involved in creating a C program 
The first sample program, Temperature, is analyzed in detail and 
should reassure you that C is understandable. This analysis also 
points out important distinctive features of the language Next the 
chapter gives descriptions of some of the library functions available 
in the Amiga- C compiler. Finally, a number of sample programs 
are mcluded to give you examples of C content and form These 
programs are not analyzed here, but you can enter them and ex- 
periment in ortier to learn some of the ways you can use the C 
language. 

This chapter does not pretend to be a complete introduction to the 
C language The best way to learn C is to find a good book on the 
language and use it with a C compiler and the Amiga manual Be- 
cause of the popularity of the language, C books can be found at 
regular bookstores throughout the country. Several excellent books 
and manuals are listed at the end of this chapter 



Compiling a C Program 

r pr °f rammer fammar *** BASIC or ^8°' C can be an in- 

aWe R^FAn ? ** ^ Unlike rea <% understand- 

able READ command of BASIC or the familiar LEFT command 

7i T C Pr0gram contain such ^ems as i++ or 

ri. Bitftep = U,. After the initial shock subsides, however, you will 
discover that C really is not that difficult after all. 

Because C is a compiled language, you will notice another difference 
when you compare C to BASIC or Logo. When you are programming 
m Amiga BASIC or l^ go . the ^ mp ^ r monl £ 0 JK J^^ 
enter them. If errors are found, you are told immediately. After you 
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enter all the appropriate program lines, a request to RUN the pro- 
gram causes the computer to interpret your requests and perform 
accordingly. If you have made errors, BASIC provides an editing fa- 
cility to correct them. Programming in C, however, is more indirect. 
As you write your program, the computer stores the information as 
text in a file on an Amiga diskette. In fact, the computer doesn't 
even recognize that you have put a C program into a file For all 
the computer, "knows," you might have written a letter to your 
^randmotherf 

After - C program has been entered, you tell the computer to com- 
pile the program. Compiling is the process by which the compiler 
converts the C program source code, the text you have entered into 
object code, which the machine can understand. Even with a short 
program, this compilation process may take a few minutes For 
longer programs, you might want to have this book handy for reading 
while you wait. 6 

You can find several solutions to the problem of time. One solution 
available on many machines is to place the compiler and program 
source code in the machine's RAM memory, where operation is 
much faster than with diskettes. 

A second solution is to subdivide C programs into smaller functions 
Once a function has been written, compiled and debugged it is 
available for use by any program. For example, the portion of the 
program that displays messages on the screen can be written and 
debugged separately from the rest of the program. After all the parts 
are working, they can be linked to produce a complete program. 

The C Compiler from Commodore (made by Lattice, Inc.) provides 
a feature that makes the process of C programming more manage- 
able When you are using this compiler, the text editor, compiler 
and linker all can be displayed simultaneously. Because the Amiga 
has multitasking capabilities, all of these tools can work at the same 
time. 



Steps for Writing a C Program 

Writing a C program is a four-step process. A description of each 
part of the process follows. 

1 Create and odit tkc v&Uree fife. Uoiog (lit icxi CdllOl, 

create the source code for the C program. Here you 
define functions, tell the computer what you want 
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done, and enter the required C program statements. If 
you find the editor supplied with the Amiga to be too 
primitive and you plan to spend a great deal of time 
with this tool, you might want to purchase a better 
editor. One possibility is the EMACS program, which is 
a free software program available through Commodore 
user groups. 

Compile the source file. The second step of the process 
is the compilation of the C source code into an 
intermediate form usable by the linker. During this 
step, you are notified of any C program errors that you 
may have made. To correct the errors, you must return 
to the editor. Remember: to speed the programming 
procc^, you can create small portions of your program 
independently. After you have compiled an error-free 
program, the computer produces an object file for use 
by the linker. 

3. Link the object files ivitb the library. To produce a 
working program, you must integrate the object files 
(created with the compiler in step 2) with the library 
functions (such as the functions for input and output). 
In this step, the linker takes your program object files 
and combines them with the necessary library functions 
to produce a working program. Unfortunately, a 
working program is not necessarily a correctly working 
program; hence, the next step. 

4. Debug the program. Once a program is created, it 
must be tested to ensure that all of it works as 
intended. In the debugging stage, you discover the little 
(or big) problems that must be corrected. From here, 
you return to the editor where you correct any 
mistakes and begin the process of program creation 
again. 

Several C editors and compilers are on the market for the Amiga 
An excellent editor/compiler is from a company that markets C com- 
pilers for everything from the Commodore 64 to the Amiga The 
Aztec C package is available from Manx Software Systems (P O Box 
55, Shrewsbury, NJ 07701). The package is available in three ver- 
sions: personal ($199), developer ($299), and commercial ($399) 
Th« Bret ts too limited iu be recommended, but the developer and 
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commercial versions are excellent products. They were used in de- 
veloping the programs for this chapter. 1 

A Simple Example 

The easiest way to illustrate that C is not as intimidating as you 
might fear is by presenting a sample C program. The sample shown 
here is a well-known program that prints Fahrenheit and Celsius 
temperature values. This program, which is presented fairly early in 
the "standard" C la* j">tje hook, Kernighan and Ritchie's The C Pro- 
gramming Language, is a simple example of C operation. 

The Temperature program that follows counts from 0 to 300 in steps 
of 20 degrees and displays the corresponding values for Fahrenheit 
and Celsius. 



/* 

•This program prints Fahrenheit and Celsius degrees from 0 

* to 300 in steps of 20 

*/ 



main () 
C 

int lower, upper, step; 
float fahr, Celsius; 

louJ9r = 0 < /« Lower limit of temperature */ 

upper - 300; /* upper limit */ 

step = 20; /# Increment */ 

fahr = lower; /* Begin at lower limit V 

while (fahr <= upper) C /* Begin while loop V 

celsius = (5.0 / 9.0) * (fahr - 32. 0) ; 

printf V/A.Qf '/A lf\n", fahr, celsius); 

fahr = fahr + step; /* Get next temperature */ 

^ /* End while loop */ 

A End program »/ 

Features of C Programs 

Before you examine the program lines in detail, vou can learn from 
this program several important features of C. These distinctive char- 
acteristics apply to all C language programs. 
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1. All C programs must contain a function called main( ). 
This function serves as the starting point for execution. 

2. All C statements end with a semicolon. 

3. C statements may be grouped within curly braces ({ }). 
For example, the contents of the whi le loop begin 
with the opening brace and end with the closing brace. 

4. Comments are marked off from the rest of the program 

a combination of the slash and asterisk characters 
(/« - ^e^iing and */ for ending). 

5. C programs m~y be indented (as with the while loop) 
to increase readability. While not required, good 
indentation and layout makes programs look neater and 
makes them easier to modify and debug. 

Analysis of the Program Lines 

With these preliminaries out of the way, you now can examine the 
Temperature program a few lines at a time. 

The program begins with a comment that tells you what the program 
is designed to do. In this case, the program is supposed to print 
Fahrenheit and Celsius temperature values. 

/* 

* This program prints Fahrenheit and Celsius degrees from 0 

•to 300 in steps of 20 

*/ 

his program, like all C programs, must contain a call to the ma i n ( ) 
function. This is the starting point for execution of the program. 
The empty parentheses tells you that the main function expects noth- 
ing else to be supplied for its operation. The opening brace after 
main( ) signifies the beginning of the function (and in this case, the 
entire program). 

main ( ) 
C 

Unlike BASIC, where variables can be created "out of the blue," C 
requires that variables be declared before they can be used. The 

next two lines declare five variahl«»s for ncp Ky program. Three 

of these variables (lower, upper, and step) are declared to be in- 
tegers (int); the other two variables (fahr and celsius) are de- 
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clared to be floating-point numbers ( f 1 oat). Note that program lines 
that declare variables always end with a semicolon. 

int lower, upper, step ; 
float fahr, celslus; 

The next three lines of the C program initialize the lower limit, 
upper limit, and step value for the program. The fourth statement 
sets the variable fahr as the value of lower (that is, zero). Note that 
comments may be placed on program lines. 

lower = 0 ; /» Lower limit oi + *<nDerature */ 

upper = 300; /* Upper limit */ 

step = 20; /* Increment »/ 

fahr = lower; /* Begin at lower limit */ 

The next C statement uses the while command to create a loop. 
The program will loop through the bracketed commands while fahr 
is less than or equal to the value of upper, which is 300. (At the 
bottom of the whi le loop, fahr will be incremented by the value 
of step, which is 20.) The opening brace marks the beginning of 
the wh 11 e loop. 

while (fahr <= upper) £ /"Begin while loop*/ 

The wh i 1 e loop contains three statements. The first of these is simply 
an instruction to calculate the corresponding value of Celsius (in 
the C program, celsius) from the specified Fahrenheit temperature 
(fahr). 

celsius = (5. 0/9. 0) * (fahr - 32. 0); 

The next statement in the while loop handles the printing of the 
Fahrenheit and Celsius temperature values. 

printf 014. 0f Z6.1f\n", fahr, celsius); 

The printf command is a call to a C function that performs the 
formatted printing operation Unlike the main( ) function, which 
does not have any values within its parentheses, printf seems to 
have everything but the kitchen sink between the parentheses. The 
'/A. 0f and the Ji6. If tell the C program to print fahr and celsius 
(respectively) with four digits and no decimal places {'/A. 0f ) and 
with six digits and one decimal place (/i6. If). The spaces between 
the two items will be reproduced on the output line so that the 
Fahrenheit and Celsius values will be separated. The funny-looking 
\n" tells the Amiga to move to the next line after the program has 
printed the Fahrenheit and Celsius values. 
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The last three lines of the program increment the counter for the 
while loop, complete the while loop, and signal the end of the 
main( ) function 

fahr = fahr + stgp ; /* Get next temperature »/ 
? A End while loop »/ 

3 /* End program »/ 

This is a good time to note that with indenting you easily can see 
that the first closing brace applies to the whi le loop, and the second 
refers to the initial cpciilng brace after the main ( ) function 

Library Functions 

In C, all functions except main( ) are library functions. These func- 
tions are stored in a library and can be accessed by any program at 
any time. This concept greatly increases the flexibility and usefulness 
of the C language. Some of the more frequently used library func 
tions, explained in the sections that follow, have to do with input 
and output and with strings and data types. 

Input and Output Functions 

Any prograrnming language must provide some means of commu- 
nicating with the outside world. BASIC uses INPUT and PRINT state- 
ments to accomplish this task C uses the functions printf, scanf, 
gets, and puts for input and output. 

The printf and scanf Functions 

In C, all formatted input (from the keyboard) and output (to the 
screen) is handled by a set of function calls. Input is controlled by 
the scanf function, and output is accomplished by the printf func- 
tion. These functions are shown in the following lines along with 
their generic argument lists. 

scanf (format, expi, exp2, ...) standard input 

printf (format, expl, exp2, . . . ) standard output 
A format string consists of text to be printed or matched. This text 

contains format Specifiers which determinp rUt* 5 ppMMnc« and 

types of the data. In the Temperature example, the format string*is 
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'/A. 0f '/£. lf\n". The expressions (expl and exp2) are fahr and 
celslus. i 

A format specifier has this form: 

V. ZID L. PI CH (conuersion character> 

The elements of the format specifier are as follows: **£ 

Forces left-justification (in printf only) 

W Width in characters (leading 0 means padding 

with zeros) 

P Precision (decimal places). In the example, 

celsius is printed with one decimal place. 

1 Specifies long integer or double 

A conversion character controls how the data itself is printed. Here 
are the conversion characters along with their definitions: 

Character Definition 

d Signed decimal integer 

u Unsigned decimal integer (printf only) 

x Unsigned hexadecimal integer 

h Unsigned hexadecimal short integer (scanf only) 

o Unsigned octal integer 

c Single character 

s Null-terminated string 

f Fixed-point notation for float or double 

e Scientific notation for float or double (printf 

only) 

g Use either Va or '/.f, whichever is shorter (printf 

only) 

In the Temperature program, you can see where the variable celsius 
was printed as a 76. 1 f value. From the preceding lists, you can see 
that C was supposed to print a floating point number with one digit 
to the left of the decimal point. 
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The gets and puts Functions 

TTie gets and puts functions work with strings of data. The function 
gets receives a string from the keyboard; puts dMaw HS£ 
Actually, both functions operate bu ^ Sect isTe 

same: the function either "gets" or "puts" string 1„ ,! 
W. . * found ^ ^.rp^S^ J~ 

Math Functions ' ^ 

Unlike BASIC, which has many math f^m.. ^ t 

dition, subtraction, mulUpS^S T^mtsn^" 

tiiat you can include in your programs when needed To mclude7 
file m your program, you use a statement like this * 

#include <i ntuiti on/math. h> 

to.S bray ^ 3 C ° mp,ete « of trigonometric func- 
* SdS " ^ ^ ** foUo - ' * measured 

x = sin(r) ; Sine of r 

x = cos(r) ; Cosine of r 

x = tan(r) ; Tangent of r 

x = acos(r) ; Arccosine of r , 

x=asin(r) ; Arcsine of r 

x=atan(r) ; Arctangent of r 

x = atan2 Cy, r ); Arctangent of y divided by r 

x = cosh Cr) ; Hyperbolic cosine of r 

* = sinh(r) ; Hyperbolic sine ofr 

x = tanh(r) ; Hyperbolic tangent of r 

definitions: ° f ^ foncti <>ns with their 



Function Definition 

» = exp (t) ; Exponential function e' 

* = 5?rt(t) ; Square root oft 

* = 0 |t)j Logarithm (base-e) of t 
X = 1 ° fll0(t); Logarithm (base-10) of t 

>>> Computer t to they powers 

~ J— 

*e maximum integer ailowef on thT^ ' ""^ " P l ° 
x = rand( ), 

and Other Data Types 

The ^taTS^tS^! 
(and virtually all C comnil^r^ L lattice C Compiler 

-d copy strings S^^"^ » ;»W 
plained in the sections th« (ST" = SSe '"""'ons are ex- 

and other C JetonT f dCtaiIs ° n *« 

your C compiler * C docum «^on supplied with 

The strlen Function 

^ch^rrforr,'^ ° f * -*« * «* «*« 

length = strlen (s) ; 

The strcmp Function 

-it^Se^r ^ ^ "*» (^gnatec, 
x = strcmp (si, s 2) ; 

^olr^r*^f»«e action ret.™ 



negative s i < s2 

zero sl = s2 

positive sl > s2 



"Mary" < "Terry" 
"Tim" = "Tim" 
"zebra" > "yak" 



The strcpy Function 

The strcpy function r™»« rt ;< ' ' ' if: * ' v - 

copied toCSg ™ P 1CS ° ne Stnn « t0 — ™e string s Zis 

'.'i. 1 :-,; « iS be - 

strcpy (sl, s2) 



The stpchr Function 

*e vaiue of pt is 2 ..cause m is ^^^^ ' *' 
pt-stpchr(s. c) 

The strcat and strncat Functions 

S «*0 specked 
the second (strncat) concaten"^ C ° ncatemKs "™ brings, and 
acten. In the exampYJ ™ S T ^ll H ^ ""^ of re- 

compute,-, dther rfCfoilnL^ ,2 ' fnl ^. »d s3 = fta, iga 

* (Commodore 8 C ~' ,S * e stri ^ 

s4 = strcat(sl, s2) 

54 - StrnCat(31 ' * » " 'He first 5 characters 

of Amiga computer" */ 

Sample Programs 

Now that you have studied the basics n f * 
guage, you are ready to look at sn m 7 , Programming Ian- 
AU of meprognunftha t&^ZtStt******* 
Compiierpubhshed byCommodo™ ££££££ **** C 
A-g, enter me prog™ md expab J mt £ « 7« 
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you a clearer idea of how C works and help you decide whether 
you want to learn more about this language 

Window Maker 

The first sample program, called Window Maker uses the builr in 
Amxga routines to create a window on the video screen ^ 
^ corner of the window will be at coordinates (20,20) anTSe 
initial dimensions will be 300 by 100. Maximum (640 byW ™h 
£~ (,00 by 20) dimensions are specified fo £ w^W 
You cam. ^ ^ mouse to ^ the ^ ° ^ ™dow. 

menaons. Window Maker demonstrates the power of boft l C 
language and the Amiga. 0th 1116 C 



/* This is how you open a new window */ 

#include <exec/types. h> 
include <intuition/intuition.h> 

struct IntuitionBase «IntuitionBase- 
int *0penLibraryO, -OpenUindowO; ' 

mainO C 

struct NewUindow NUind; 
struct Window *wind ; 

/* Open the intuition library */ 
Intuit ionBasQ = 

printf ("Can't open I ibraryV)- 
^ exit(0) ; ' ' 

NUind. LeftEdge = 20 ; 
NUind. TopEdge = 20 ; ' 
NUind. Uidth = 300 ; ' 
NUind. Height = 100 ; 
NUind. DetailPen = 0 ; 
NUind. BlockPen = i- ' 

NUind.Titl e= (UBYTE*)"Thi S is ay window" . 
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NUind. IDOIPFlags = CLOSEUINDOU ; /* Report if window is closed */ 
NUind. Type = UBENCHSCREEN, 
NUind. FirstGadget = NULL; 
NUind. CheckMark = NULL; 

NUind. Screen = MJ_L ; /* Use Uorkbench screen (default) */ 

NUind. Bitflap = NULL; 

NUind. MinUidth = 100, 

NUind. MinHeight = 20; 

NUind. MaxUidth = 640; 

NUind. MaxHeight = 200, 

if ((wind = (struct Uindow *)OpenUindow(&NUind)) == NULL) C 
printf ("Can' t open window\n")' 
exit(0) ; 

} 

/* Uait until user closes the window */ 
Uaitd « wind->UserPort->mp_SigBit); 

CloseUindow(wind); 
exit(l); 

} 



Simple Sprite 

One of the functions available on the Amiga generates sprites These 
are multicolored graphic figures that can be created, changed and 
moved around the screen. The following program creates a simple 
sprite, which you can move around the screen. Press the U D L 
and R keys to move the sprite up, down, left, and right, respectively! 
Press Q to exit from the program. 



/* 

* Simple Sprite 



* Enter u, d, I, or r to move sprite up, down, left, or right 

* To Quit, enter g. Note that character input is buffered so 

* you eventually must press RETURN 
*/ 
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#include <exec/"types. h> 
#include <exec/exec. h> 
#include <graphics/gfx. h> 
#include <graphics/sprite. h> 
#include <hardware/dmabits. h> 
#include Oiardware/custcn. h> 
#includQ <hardujare/blit, h> 

struct SimpleSprite sprite; 
UUORD spritejata C]= 
C 

100 . 10 0- /* Hosi + ton */ 

0xff00, 0xff00 

0xff00, 0xff00, 

0xff00, 0xff00, 

0xff00, 0x00ff, 

0xff00, 0X00ff, 

0xff00, 0x00ff, 

0xf0f0, 0xff00, 

0xf0f0, 0xff00, 

0xf0f0, 0xff00, 

0xffff, 0xffff, 

0xffff, 0xfff, 

0xffff, 0xffff 



struct GfxBase *GfxBas@ ; 

main () 
i 

int c, sp ; 



GfxBasQ = Open! ibrary ("graphics, library" 0). 
if (GfxBasQ NULL) C 

printf ("no lib"); 

exit (0) ; 

} 

if ((sp = GetSprite (Sprite, -1)) == -1) { /« G et any sprite */ 
printf ("No sprite" !!"); ' 
exit (0) ; 

} 
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sprite, x = sprite, y = 100 ; 
sprite, height = 12; 

ChangeSprite(0, ^sprite, sprite^data); 

while (1) C 

switch (c = getchO) C 
case ' g' : 

break; 
case ' 1* : 

HoueSpriteCft Sprite, sprite, x - 1, sprite.y). 
Break; 
case ' r' = 

rWSprite(0, ^sprite, sprite, x + 1, sprite y)- 
break; ' 
case ' u' : 

MogeSprite(0, Sprite, sprite, x, sprite.y - 1) ; 
break; 
case ' d' = 

MoveSpriteC0, ^sprite, sprite, x, sprite.y + 1)- 
break; 

} 

if (c - '„') C 

FreeSprite(sp); 
break; 

3 

} 

} 



Copper Processor Disassembler 

In the Amiga, the Copper processor is the video microprocessor It 
can be monitored by looking at the program counter (the PC^le 
a program is executing. The PC is essentially the Amiga's pointer 
m^e Copper processor. The Copper Processor Disassembler pro- 
gram allows you to move forward and backward in memory by press- 
mg the semicolon (;) and colon ( : ) keys, respectively You Sn 

^ e Y^ e r te ? of \ memoiy iocation * e ^ 

1° u'7 8 ° tG my location m m emory by typing P followed 

by the desued memory location. Finally, if you lZ to <w"S 
somcthong m memory, you type H, followed by the number of words 
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you want to search for and then the specific words. All in all the 
Copper Processor Disassembler is a most interesting program for 
examining any part of the Amiga's memory 



* Copper List Disassembler 



* ■ >-«.■■-.", 

^ « PRESS; RESULT: 

* f/f Disassemble instructions at PC 

* V Increment PC and disassemble 

* Decrement PC and disassemble 

* 'p' Set the program counter 

* h' Enter hunt mode 



s Print address of current copper list 

Enter a word into memory at current address 
' Q" Quit the program 

* In hunt mode, enter number of words you want to search 

* for, then enter the words one by one. To toggle ROM 

* search, enter a negative number as the number of bytes 

* (Uithout the ROM search, only the RAM will be searched. ) 
« To quit hunting, enter zero as number of bytes 

*/ 



#include Cexec/types. h> 
#include <graphics/gf xbase. h> 
#include <graphics/view. h> 
#include <graphics/copper. h> 

void huntO; 

int *OpenLibrary() ; 

struct IntuitionBase "IntuitionBase,- 
struct GfxBase *GfxBase ; 

mainO 
C 

struct View *Uiew ; 
unsigned short i, j, »p, * pC; 
char CD3J; 
int k ; 

UUORD *clist ; 

IntuitionBase - 

(struct IntuitionBase *)OpenLibrary("intuition. library", 0) ; 
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GfxBase = (struct GfxBase *)OpenLibrary("graphics. library", 0) ; 
if (GfxBase == NULL II IntuitionBase == NULL) C 

printf( "Can't open 1 ibrary. Sn") ; 

exit<0) ; 

} 

P = 0; 

while (1) C 

printf(">")j 
scanfC'Xs", fcc); 
switch (cC0]) C 
cas* ' ?' : 

DC =2; 

gu„. Hoi Ine; 
case *;* : 

PC += 2; 

case ' /* = 

do 1 ine : 

P = PC; 

printf(VJ6x:", p) ; 

i = » P ++; 

j = *P++; 

printfC Mix VMx ", i, j) ; 
if ((i & 1) = 0) C /* MOUE */ 

printfC'MOUE #*04x, *03x ", j, i) ; 

3 

else C 

if ((j & 1) == 0) 

printfCUAIT"); 

else 

printfC'SKIP"); 
printfC W-'/m* Up:/i02x HE=K02x UE^02x BD=Kx 
(i » 1) 5, 0x7f, (i » 8), 
(j » 1) t* 0x7f, (j » 8) & 0x7f, 
(j 5. 0x8000) 8& i 
); 

3 

break; 
case ' =' • 

printf('706x: /<04x ", (int)pc ( *pc) ; 
scanf("/!x", &k); 
*pc = (short)k; 
break; 



case ' p' : 

printf("PC=") ; 
scanf (•%(", Jcpc); 
break; 
case ' s' : 

clist = GfxBase->ActiView->LQFCprList->start- 



printfCCList is at 5*06x\n", (int)clist); 



break; 
case ' h' : 

huntO; 

break; 
case ' g' : 

exit(l); 
breaks- 



static short *ptr, »tmp, i = 1, uiordC163; 
static int j, k, n, f, skip = 0 ; 

while (1) £ 

j = 0; 

printfC'SnHUNT:"); 
scanfC'Jid", 6,f); 
if (f == 0) 

return; 
if (f < 0) C 

skip = -skip ; 
printfC'ROM search ") ; 
if (skip) 

printfC'off"); 




} 



3 



} 



void huntO 
C 



else 



printf ( 



on"); 



continue; 



3 

while 



Cf~) C 
printfC? "); 
scanHW, &n) ; 
wordCj-H-: = (short)n; 



3 
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not founds 



notfound2; 



for (ptr = (short *)0 ; ptr < (short *)0x40000 ; p tr++) { 
tmp = ptr; 

for (k = 0 ; k < j ; k++) 

if (*tmp++ != W ordCk3) 
goto notfound; 

if (ptr!= word) 

printfC YM*" t (int)ptr); 

if ( !skip ) C 

tmp = ptr + 0xf 80000; 
**>r ik = 0- k < j[ k++) 

if («tmp++ \= wordCk]) 
goto notfound2 ; 
printfC YMx'\ 0xf80000 + (int)ptr); 

tmp = ((short *O0xfc0000) + ptr ; 
for (k = 0 ; k < j ; k++) C 

if (*tmp++ != uiordCkD) 
continuQ; 

printfC X08x", (int)ptr + 0xfc0000) ; 



} 

return; 



Blitter Screen 

graphics screea 1 WjU be dls P%ed on the 



struct vi yum u> » . r , 
struct Raslnfo ri; 
struct Bittlap b; 
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m % v; * 



c 



0x1414, 0x1414, 0x0014, 0xffd7, 

0x0014, 0xffd7, 0x1414, 0x1414, 

0x1414, 0x1414, 0x1400, 0xd7ff, 

0x1400, 0xd7ff, 0x1414, 0x1414 

0, 0, 0, 0, 0, 0, 0, 0, 0, 0, g, 0, £ .0^ . '0 ( . 0 

/» 16 zeros here */ 1' 



for (i = 0 ; i < DEPTH; C A Allocate enough r^mory for bitmap */ 

if (Cb. Planes CiD = 

(PLANEPTR)AUocMem(UIDTH * HEIGHT » DEPTH / 8 
MEMF_CLEAR)) == NULL) C 

printfCOut of memory! Try using fewer planes \n")- 
exit (0) ; 

J 



/* Opon fl^pKiea library V 

prlntf ("Can't open graphics library \n"). 
_^ exit(0) ; 

vp, /» Link Uieuj and Uiewport structures V 
InltBiW**. E^PTH, UIDTH, HEIGHT), A Set up Bitmap structure V 

^ Link Bitmap to Raslnfo structure V 



V 



ri. BitMap = &b ; 
ri.RxOffset = 0 ; 
ri-RyOffset = 0; 



cm. Type = 0 ; 

cm. Col or Tab 1 color; 
cm. Count = 8, 

InitUPort (8<up) ; 
vpColorflap = &cm ; 
"P. Dwidth = UIDTH 
vp.DHeight = HEIGHT- 



a S?!tT° T s ^ color ^ v 

A Point to color array V 

/•Initialize default UiewPort values */ 
Give Ui ewPo rt some specs */ 



run. 
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* To exit the program, move the mouse to the upper left side of the 

* screen, then press the left button. Then, you can save the screen 

* that was just created by answering the computer's Questions 

- Later, if you want to uieu< the same plot, just run this program 
' *" d an5 " er '{ when the computer asks, "Do you want to see an old plot?" 
men enter the name of the previously saved plot file 



* Try these values for xl x2 yl y2 = 



-2.00 
-0.30 
0.00 
0. 12 



0.50 
0.30 
0.30 
0. 16 



1.25 
-1. 10 
-0.80 
-0.70 



1.25 
-0.50 
-0.50 
-0.59 



Most of the plot can be seen. 
Zoom in to see part of it. 
Zoom in further. 

Even further. Uowf It's beautiful. 



#include <exec/types. h> 
#include <intuition/intuition. h> 
#include <graphics/gf xmacros. h> 
#include <stdio. h> /* For Lattice, 
#include <1 ibraries/dos. h> 

PLANEPTR AllocRaster() ; 

struct IntuitionBase "Intuit ionBase ; 
struct GfxBase *GfxBase ; 



It's <lattice/stdio. h> •/ 



#def ine HEIGHT 200 
#define UIDTH 320 
#define DEPTH 5 



A Vertical resolution »/ 
/* Horizontal resolution */ 
/* Number of bit planes */ 



#define XSIZ 
#define YSIZ 



UIDTH 
HEIGHT 



#define NCOLORS 64 

#def ine CMBITS 6 

#define CMSIZ (KCCMBITS) 



/* Number of colors in colormap */ 
/« Log2 of NCOLORS */ 



#define NBITS 26 

#define BSIZ ( (double) (KCNBITS) J 
#define bd(x) ((int)((x) * BSIZ)) 
int *OpenLibrary() ; 



3; 



mu-, i^j-L, V*x±., \*ju_ f mum, HblbHI, UiU\H 

HEIGHT, CUSTOMSCREEN 
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xl = bd(rxl); 
x2 = bd(rx2) ; 
yi = bd(ryl); 
y2 = bd(ry2); 

dx = X2 - Xl; 

dy = y2 - yl ; 
pdx = dx / SIZ; 
pdy = dy / SIZ; 

Intuit ionbC\j*> = 

(struct Intuit ionBase *)OpenLibrary("intuition. 1 ibrary", 0) ; 
if (IntuitionBase == NULL) 
ex it (FALSE); 

GfxBase = (struct GfxBase ») 

DpenLibraryC'graphics. library", 
if (GfxBase == NULL) 

exit(FALSE); 

InitBitMaptebm, DEPTH, UIDTH, HEIGHT); 

for (i = 0 ; i < DEPTH; i++) 

C 

bm.PIanesCi] = (PLANEPTR)Al locRaster (UIDTH, HEIGHT); 
if (bm.PlanesCi] == (PLANEPTR)NULL) C 

printfC'Out of memory. \n") ; 

exit(FALSE); 

3 

} 

NewScreen. CustomBitMap = Ecbm; 

if ((Screen = (struct Screen *)OpenScreen(&NewScreen) ) = NULL) 
exit(0) ; 

NewUindow. Screen = Screen; 

if ((Uindow = (struct Uindow «)OpenUindow(S<NewUindow) ) == NULL) 
exit(FALSE); 

rp = Uindow -> RPort; 

up = ViewPortAddress(Uindow); 



sexornoi rp, jmu ; 



f* bet draw mode to JRm */ 
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LoadColors(yp); /* Load color map for this viewport */ * 



if (*str = 'y') C 

f ileRLK&bm, ' r' , name); 

Uaitd « Uindow->UserPort->mp_SigBit) ; /* Uait for a message */ 
CloseUindouj(Uindoiij); 
CloseScreen(Screen); '/ - ; " >%Iv*i? 

exit(TRUE); 7 
- % " } ■ r> - 

Starts ? 
printfCZd 7.d 7.4 7.6 7.6 7.d\n", xl, yl, x2, y2, dx, dy, ; 
SetRast( rp, 0 ); /* Initialize entire rastport to coiiir 0 */ 

for (py = 0, y = yl ; py < YSIZ; py++ y += pdy) 

for (px = 0, x = xl; px < XSIZ; px++ x += pdx) C 



if (Uindour>UserPort->mp_SigBit) C /* a message? */ 

enter : 

message = GetMsg(Uindow->UserPort); 
if (message->Class == tlCHJSEBUTTONS) C 

ReScalefmessage-XlouseX, 
message->MouseY) ; 

goto Start; 

3 

else if (message->Ciass == CLOSEUINDOU) C 
UBenchToFrontO; 

printf("\nShould I saue this plot for \ 

future viewing? (y/n) "); 

scanfC/is", str) ; 
if (* s tr = 'y') C 

printfC'SnEnter filename:"); 

scanfC'Xs", name); 

fileRUCkbrn, 'w\ name); 

3 

CloseUindou(Uindow); 
CI oseScreen (Screen); 
exit(TRUE); 

3 

5 * 

color = mandeKx, y) ; 

Color(rp, color, px, py) ; 



J 



UaitCl « UindourXJserPort->mp_SigBit); A wait for a message */ 
goto enter; 



mandeKax, ay) 
int ax, ay ; 
C 

register int zx, zy ; 
register int wx, uy, inag ; 

int iter, color; 

iter = zx = zy = wx = wy = ftla g , 0. 

while (mag <= (4 « NBITS) iter < NCOLUfO C 
iter++ ; 

*y «= 1; 

zy = bmuKzx, zy) ; 
zy += ay ; 

zx = ax; 

ZX += WX; 
ZX -= W y ; 



wx = bmuKzx, zx); 
wy = bmulCzy, zy) ; 
mag = uix ; 
mag += wy ; 

3 

color = ((iter « DIBITS) / COLORS) I (CMSIZ - i). 
^ return 5 cale(color) ; /* Just a little more color resolution V 

bmuHa^b) A 64-bit multiply with built-in right shift NBITS */ 
i 

register unsigned short alo, bIo ; 
register unsigned short ahi, bhij 
register int z ; 



int sgn ; 
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sgn = a A b; ( 

a = (a >= 0) ? a •■ - 8j 
b = (b >= 0) ? b = -b,' 

alo ^ ((struct sh *) (8, a ) )->i 0 . 
aM = ((struct sh ») (&a) )->hi ; 

bio = ((struct sh *)(8cb))->lo ; 
bhi = ((struct sh *)(Seb))->hI; 

z = (( (unsigned) (alo*blo)) » NBITS) 

+ (((unsignQd)(alo»bhi + ahi*blo)) » (KBITS - 16)) 
+ (((unsigned) (ahl*bhl)) « (32 - NBITS)) ; 

return ((sgn >= 0) ? z ■. 



SHORT color, x, y. 

SetAPen( rp, color); 
UritePixeK rp, x, y ) ; 



LoadColors(up) A Set up color map »/ 

struct Viewport *up- 

C 

register int n ; 
register int r, g, b ; 

n = 0 ; 

for (r = 0 ; r < 16 ; r += 8) C 

for (g = 0 ; g < 16; g += 4) { 

for (b = 0 ; b < 16; b += 4) C 

if (n > 32) return(TRUE)- 
SetRGB4( „ Pj n , r, g t b ) ; 
n++; 

3 



196 



AMIGA PROGRAMMING GUIDE 



ReScale(mx, my) /* Scale new coordinates V 

LORD mx, my ; 

C 

double cxl, cx2, cyl, cy2 ; 

cxl = (double)Umx - 40) / SIZ * (rx2 - rxl)) + rxl 
rxl = CXi; 

cx2 = ( double) Umx+40) / SIZ * (rx2 - rxl)) + rxl 
rx2 = cx2 ; 

cyl = (double)((my - 40) / SIZ » (ry2 -ryl)) + rvl- 
ryl = cyl; . 3 ' 

cy2 = (double)((my+40) / SIZ * ; v2 - *yl)l + rvl 
ry2 = cy2 ; ' ' 1 ' 

xi = bd(cxl); 
x2 = bd(cx2) ; 
yl = bd(cyl); 
y2 = bd(cy2) ; 

•Jx = x2 - Xl; 
dy = y2 - yl ; 
pdx = dx / SIZ; 
pdy - dy / SIZ; 



• , o ° rS St3rt ° Uer If ™y smal * ambers are to be 

^used for xl, x2, yl, and y2, then NCOLORS should be increased 



scale(colors) 
int colors; 
C 

int SC; 



sc = colors / 2; 

return colors - sc * 32; 



/* GenQral purpose load/save routine for bitmaps 

* bm is a pointer to your BitMap structure. 
» c ='r' for load and W for save. 

• Note: you might *uant to saue the current colors as u*ll. 

fileRU(bm, c, name) 
struct BitMap *bm ; . 
char c, *nam@ ; 
C 

FILE *fp, s»n P en() ; 

int len, plane, bytes, mode; 

if (c == V ) 

mode = M0DE_OLDFILE ; 
else if (c 

mode = MODE_NEUFILE; 

else { 

printf("\nlnualid I/O mode"), 
return 0- 

} 

if ((fp = OpenCname, mode)) == NULL) C 
printf("\nCant open Y.s\ name); 
return 0 ; 

} 

bytes = Cbnr>BytesPerRow)*(bm->Rows)- 
for (plane = 0 ; p l ane < bm->Depth; plane++) £ 
if ( c == 'r' ) 

len = Readffp, bm->PlanesCplane3, bytes)- 
else ' 

len = Urite(fp, bm->PlanesCplaneD, bytes), 
if (len != bytes) C 7 ' 

printf("SnError in I/O to filers", name); 
Close(fp) ; 

return 0, 

) 

} 

Close(fp); 
return 1 ; 
} 



* 
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Mouse Function 

The Mandelbrot Explorer program introduced you to the mouse- 

the Mouse Function takes the use of the mouse one step farther' 

The Mouse Function monitors the x and y coordinates of the mouse 

position on the screen. The function can be useful as a component 

of a larger drawing program or in a program that uses the mouse's ? >~ 

position to make choices. Note that the function is not a complete 

program because the lines contain no main ( ) function; instead the ?: 

Mouse Function would be used in a larger program to monitor 

mouse activity. The Mouse Function also checks the mouse bu. i 

The function returns a value of zero (0) if the mouse button has 

not been pressed and the mouse has not moved. If the mouse button 

has been pressed, a -1 is returned. If the mouse has moved but the 

mouse uutton has not been pressed, a 1 is returned. 

/* Mousq Function 

* This function updates absolute x and y coordinates of the mouse 

* Before calling mouse () in your program, you must call initmouseO 

* In tmouse needs to be called only once. Subsequent calls to mouse () 

I £ J "S?!? 9l0bal V3riableS and You must cal1 <™ s <^ «t least 

* 50 to 60 times a second. mou.aO should be part of an interrupt routine 

* that gets called every screen refresh (60 times a second) 

* mouseO returns zero if the mouse has not moued since the last call and 
« the left button is not currently pressed, otherwise it returns -1 

» for button pressed, and 1 for not pressed 
*/ 

#include <exec/types. h> 

#define MINX f ? '* allowabl9 value * »' 

#define MAXY 199 
#define MINY 0 

#define abs(x) U(xK0)?(-(x)) : ( x )) 

UORD x, y ; /* Mouse x and y coords */ 

char oldx, oldy ; /* Used by mouse func */ 

initmouse(xi, yi) 

UORD *i, yi. 
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UORD r ; 

X = xi; 

r = »((UORD *)0xdf000a) ; 

oldx = (char)r ; 

oldy = (char Mr » 8) ; 

} 

mouseO /» Gat mm mouse location.- rQturn 0 if no change. */ 

UORD r ; 

register UORD dx, dy ; 
register char newx, newy ; 
char button; 

r = *((UORD »)0xdf000a) ; 
newx = (char)r ; 
neu»y = (char)(r » 8); 
dx = (UORDHneuix - oldx); 
dy = (UORDMnewy - oldy)- 

button = (*( (unsigned char *)0xbfe001)) & 0x40- 
If ( dx == 0 dy == 0 button ) 

return 0 ; /# No movement, no button */ 
if (abs(dx) > 127) C 

if (dx < 0) 

dx += 0X100; 

else 

dx = 0x100 - dx ; 

3 

if (abs(dy) > 127) C 
if (dy < 0) 

dy += 0x100; 

else 

dy = 0x100 - dy ; 
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x += dX; 
y += dy ; 
if (x > MAXX) 

x = MAXX, /# Range check */ 

alse if (x < MINX) 

x = MINK; 
if (y > MAXY) 

y = MAXY; 
else if (y < MINY) 

y = MINY; 
cldx = newx ; 
" 1 dy = newy; 
if (button) 

return 1 ; /» Button has not been pressed */ 
return -1; /# Fire 1 */ 

3 



New Screens 

The first example in this section, Window Maker, creates a new 
window on the Amiga. The New Screens program creates a new 
screen on the Amiga, The screen created uses the Topaz font, has 
80 characters per line, uses normal text style, and displays "Hello 
there ! " as the title of the screen. In addition, sprites, dual playfields, 
high-resolution, and an interlaced display are all possible with this 
new screen. Notice that all this is accomplished with only 59 lines 
of C program code! 



/* Here' s how you open a new screen */ 

#include <exec/types, h> 
#include <intuition/intuition. h> 

struct IntuitionBase *IntuitionBase ; 
int *0penLibrary(), *0penScreenO ; 



mainO 
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static struct TextAttr font = C * 
(UBYTE #) "topaz, font", /* Font name V 
T0PAZ_EIGHTY, /* Eighty-column size »/ 
FS_N0RMAL, /# Normal font style */ 
FPF_R0MFQNT ,:■ 

static struct NewScreen Nscr = C 

0, /* Not implemented, se + to zero for upward compatibility */ 

0, /* Top of screen */ 

320, /* 320 for lores, 640 for hires */ 

200, /* 400 for interlaced, 200 for noninterlaced */ 

2, /* Number of colors = 2 A Depth (in this case, 2 A 2=4) */ 

0, /* Color register number for gadgets, titlebar', etc */ 

1, /« Color register number for block fills. */ 
SPRITES, /* Ue want to use sprites. Other flags that 

* may be set are : 

* HIRES for high resolution display 

* (640 pixels across) 

* INTERLACE for interlaced display 
« DUALPF for two playfields 

* HAM for hold and modify mode 
*/ 

CUSTOMSCREEN, /* Type of screen. If you have your own bitmap 

* also set the CUSTOMBITMAP flag. 

* See CustomBitMap below 
»/ 

kfont, /* text font V 

(UBYTE *)"Hello there!", /* Title of the screen V 
NULL, /* Pointer to linked list of gadgets */ 
NULL, A Point to your own BitMap structure if you want 
* to use your own display memory. 

h 

struct Screen *screen; 
Intuit ionBase = 

(struct IntuitionBase *)OpenLibrary("intuition library" 29) 
if (IntuitionBase NULL) i 

pr intf ccan' t upen iiDrary')- 
exit(0) ; 
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screen = (struct Screen *)OpenScreen(S t Nscr). 
If (screen _ (struct Screen *)NULL )T 

printf rwt open new screen. Sn») ; 



Mouse Sprite 

Tu^Z ^ — independent 

you now can move the snrir- ^ k eys, 
Sprite use, the ^F^"^,^ ^ ** MOU5e 
of the streneths of r « thJ. * m earher exan iple. One 

and then u^^T """"^ ^ * ^ "* d *"88ed 



* Simple house Sprite 



* 



•Mow the sprite around using the mouse 



#include <exec/types. h> 
#include <exec/exec. h> 
#include <graphics/gf x. h> 
#include <graphics/sprite.h> 
#include Oiarduare/dmabits. h> 
#include (hardware/custom. h> 
#include <harduare/bl it. h> 
#define abs(x) (( CxK0)?(-(x)):( x )) 

^ J ft A Mouse x and v V 

struct SimpleSprite sprite- 
UUORD sprite dataC] = 
C 

100, 100, /* Position */ 
0xff00, 0xff00, 
0xff00, 0xff00, 
0xff00, 0xff00, 
0xff00. 0x0aff 
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0xff00, 0x00ff, 

0xff00, 0x00ff, 

0xf0f0, 0xff00 j 

0xf0f0, 0xff00, 

0xf0f0, 0xff00, 

0xffff, 0xffff, 

0xffff, 0xffff, 

0xffff, 0xffff 



struct GfxBase *GfxBase ; 
int KJpQnLibraryO; 



mainO 
C 



int c, sp ; 



ir lurxuase == (struct GfxBase *)NULL) £ 



printfC'no lib") ; 
exit(0) ; 

3 



if (Csp = GetSpriteC&sprite -1)) n f r«+ 

prlrtfCH. S prU. .Uii^rNn.,,. ^ V 



exit(0) ; 



sprite, hgight = 12- /* 19 n . • L 

s '* 12 lines high V 

ChangeS P rite(0, Sprite, sprite_data) ; 
initmouse(10, 10). 
while (1). C 

while (!( C m0 use())) ; /* Get new mouse coordinate5 

~c V A If the lef t button is pressed 

FreeSprit e (sp) ; /# f ree the spritfi J pressed < 

3 exit(l); /» and quit V 

3 MoveSprite(0, Sprite, x, y) ; 
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#define flAXX 319 /* Mouse maximum and minimum allowable values V 
#define MINX 0 
#define MAXY 199 
#define MINY 0 



char oldx, oldy ; /* Used by mouse func V 

initmouse(xi, yi) „ , 

UORD xi, yi ; • f \*. 

UORD r ; , 
* = *i; 

r = *((U0RD *)0xdf000a) ; 

oldx = (char)r ; 

oldy = (char)(r » 8) ; 



mouseO /* Get new mouse location; return 0 if no change. V 
UORD r ; 

register UORD dx, dy ; 
register char newx, newy ; 
char button; 

r = *((U0RD *)0xdf000a) ; 
neux = (char)r; 
newy = (char)(r » 8); 
dx = (UORDMneuix - oldx); 
dy = (UORDHnewy - oldy); 

button = (-((unsigned char *)0xbfe00D) & 0x40. 
if (dx == 0 8& dy == 0 8.8, button) 

return 0; /» No movement, no button */ 
if (abs(dx) > 127) C 

if (dx < 0) 

dx += 0X100; 

else 

dx = 0x100 - dX; 

3 
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if (abs(dy) > 127) C 
if (dy < 0) 

dy += 0xl00 ; 

also 

dy = 0x100 - dy ; 

J 

X += dX; 

y += dy ; 

if (x > MAXX) 

x = MAXX; /* Range h k m/ 

else if ( X < MINX) 

x = MINX; 

if (y > MAXY) 

y = MAXY; 
else if (y < MINY) 

y = MINY; 

oldx = newx; 
oldy * newy ; 
if (button) 

return i^" ^ ^ Button has ^ been pressed V 
return -1 ; /« F1 „ e! m/ 



Blitter with the Mouse 

The Mouse Bitmap program integrates the Mouse function with the 

at coordinarp.: firm . screea The mouse starts 

coordinates (100, 140), as established by the #def in* command 



/* Mouse Bitmap 



* Mnally, a mouse-controlled object appears. 



#define DEPTH 3 /* Number of bitplanes */ 
#def ne UIDTH 320 /* Horizontal ro™i, J+ i_ 
refine HEIGHT 200 /* U srt ical resolution V 



/ne HINT 0 IGHT -16) 



A/a 



05g 



0£ °a6i< 



*b s( 



St* 



«0 



rt the 



/Hot §2* c "^. 

f 



140 



V 



0c >fe»o. 



, ,nt a / 



0y. 



st *ti c 



if*^ 0*555 * U 'th S t 
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3; /* Blue pyramid V 
for (I = 0 . i < uep^ 

t. /* Allocate enough memory 
* for the bitmap 
*/ 

bm-PlanesCn = 

CPL/VsEPTR)Al locflemCUIDTH * HEIGHT * DEPTH / S 

iM b m.Planesn:'rS , W)C 

printfj^t of memory. Try uslntf W planas ^ >; 

} 

} bufrm Plane ^iD = (PLANEPTR)bufrllapCii 

A Open the graphics library */ 

Pnntf(Wtop a „ sraphlc3 UbraryAn ., ; 

3 

InitUig(u(S t g). /* Init +k 

u.Vie^ort =& wp . /« Li nk th f St : Ucture with deftalt ualues V 

* structures 

InltBltMapCibufrBM, DEPTH, 16, 16)' 

ri: ifc A th ° B '^P to RUW. structur. V 

ri-RyOffset = 0 ; 

cm. Type = 0- /J( T 

™. coio™. . («^)coiJ w xxs , n rt;MT , . coior * rra * v 

cm. Count « 8; 1 to the col ° r array ./ 

InlUftrtChp), A Init „ efauIt Werfort ^ ^ 
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up. Colorflap = S<cm; A Giue the UiewPort some specs V 
yp.DUidth = UIDTH; 
vp.DHeight = HEIGHT; 
gp. Next = NULL; 
gp. Raslnfo = &ri ; 

MakeVPortteg, &gp); /* Create an intermediate Copper list */ 

f1rgCop(8<g); /* M er ge the Copper list V 

LoadView(S<y) ; /* Use uve new Copper list */ 

/* Transfer tile image to top left of screen */ 
for (n =0 ; n < DEPTH; n++) 

for (w = (UUORD *)bm. PlanesCnJ, i = 0 ; 

i .< 16; i++ us += CUIDTH / 16)) 
*w = tilemapCnJCi]; 

/* Copy the tile all oger the screen */ 
for (x = 0 ; x < UIDTH / 16; x++) 

for (y = 0 ; y < HEIGHT / 16; y++) 

BltBitMap(8<bm, 0, 0, &bm, x * 16, y * 16, 
16, 16, 0xc0, 0xff, 0) ; 

ox = XINIT; 

oy = YINIT; 

BltBitMap(S<bm, ox, oy, &bufrBM, 0, 0, 

16, 16, 0xc0, 0xff, 0) ; /* Saue background «/ 
initmouse(XINIT, YINIT); /* Init the mouse routine */ 
while (1) C /* Reset the machine to stop the prog */ 

OX = X; 

oy = y; 

while (ImouseO); A Get new mouse coords */ 
UaitTOFO; /* Ago id as much flicker as possible 

* by timing the drawing 

*/ 

BltBitt1ap(S,bufrBM, 0, 0, 5<bm, ox, oy, 

16, 16, 0xc0, 0xff, 0) ; /* Restore bkg */ 

BltBitMap(S<bm, x, y, kbufrBfl, 0, 0, 

16, 16, 0xc0, 0xff, 0) ; /«' s ave background */ 

BltBitHapt&shjpBM, 0. a &hm. x, 

16, 16, 0* C 0, 0xff, 0). /* Draw ship */ 
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char oldx, old,; /* Used by mouse f unc 

initmousetxi, yi) 
UORD xl, y|. 

UORD r- 

■ 

X = Xl; 

> = yi; 

r = »((UORD *)0xdf000a). 

oldx = (char)r ; 

o*dy = (char)(r » 8) ; 



UORD r ; 

register UORD dx, dy ; 
char riewx, newy ; 

r = *((UQRD *)0xdf000a). 
newx = (char)r ; 
newy = (char)(r » 8)- 
dx = (UORD) (new, - oldx). 
dy = (UORDHnewy - oldy)' 
if (dx == 0 dy == 0) 

if Cabs(dx) > 127) f 
if (dx < 0) 

dx += 0xl00 ; 

else 

} dx = 0x100 - dx . 

if (abs(dy) > 12?) c 
if (dy < 0) 

dy += 0xl00 ; 

else 

dy = 0x100 - dj); 
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X += dX; 

y += dy ; 

if (x > mxx) 

x - MAXX; /* Range chack »/ 

else if (x < MINX) 

x = MINX; 

if (y > MAXY) 

y = MAXY; 
else if (y < MINY) 

y = MINY; 
oldx = newx; 
oldy = neuiy; 
return 1 ; 



More Information about C 

If this chapter has whetted your appetite for C, you may want to 
purchase the Lattice C Compiler, Other C compilers for the Amiga 
are being developed and no doubt will be announced and advertised 
in the magazine AmigaWorld. 

In addition to a compiler, you will need a book on the C program- 
ming language. Here is a list of recommended books: 

Harbison, Samuel, and Guy Steele. C: A Reference Manual. Engel- 
wood Cliffs, N.J.: Prentice-Hall, 1984. 

Kernighan, Brian, and Dennis Ritchie. The C Programming Lan- 
guage. Engelwood Cliffs, N.J.. Prentice-Hall, 1978. This book is 
considered the definitive text on the C language. 

Kochan, Steven. Programming in C. New York; Hayden,-1983. 

Purdum, Jack. C Programming Guide. Indianapolis: Que Corpora- 
tion, 1983. 

Traister, Robert. Going from BASIC to C Engelwood Cliffs, N.J.: 
Prentice-Hall, 1985. 

In addition to a C compiler and a book for learning the C language, 
the developer's books from Commodore are recommended for se- 
rious Amiga programming. The set of developer's books contains the 
Amiga ROM Kernal Manual (two volumes), AmigaDOS User's Man- 
ual, and the hardware manual. This documentation explains the 

details of Amiga programming Thp ttCiM Vtyrvisil Mnmisif /^plalnc 

the 350 functions built into Kickstart and used to create animation 
sequences, stereo sound, and the other audiovisual capabilities of 
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the Amiga. These routines can be accessed from assembly language 
or from C. These manuals are packed with information for taking 
full advantage of the power resident in the Amiga Who knows . . . 
with C and the Amiga, you may even develop commercial software 
for sale. 



Conclusion 

Of the three language, "-^libed in this book, C is the most pow- 
erful, the most flexible, ana thi fastest. Of course, these features 
come at a price. The C language is also the most difficult to learn 
because of the variety of syntax rules, functions, and library capa- 
bilities it offers. Combined with the powerful capabilities of the 
Amiga, C is the language of choice for gaining access to these fea- 
tures. 



Accessing AmigaDOS 

To access AmigaDOS, you turn on the Amiga, insert the Kickstart 
diskette, and then insert the Workbench diskette when the Amiga 
tells you to do so. After you open the Workbench window, select 
the Preferences icon and look for the pan labeled CLI Yes No Move 
the mouse so that the pointer is directed at the Yes bo^ and click 
the button so that the CLI choice section displays^** Now click 
the box called Save to tell the Amiga that you wanf GLI to be avail- 
able from now on. 

When the Workbench window reappc^ double-click the System 
drawer and wait for that window to open. Noiice now that a CLI 
icon is on the screen. Opening that icon accesses the Command 
Line Interface. 

Using Directories 

AmigaDOS can give you many kinds of information. Most of the time 
the information you are going to need from the operating system 
^ctory data. A directory is an alphabetically ordered list of files 
on a diskette. To display a directory, you use the Dffi command 

To help you organize files on your disks, AmigaDOS has borrowed 
a concept used by many other operating systems: hierarchical di- 
rectories. Some other operating systems that use this method to 
segregate files are UNIX™, MS-DOS, PC DOS, and Apple ProDOS®. 
Hierarchical directories simply means that each disk can have more 
dian one directory, and that each directory can hold programs, data 
files and additional directories. These additional dLSorie can 
hold more files and more directories. 

The easiest way to think of hierarchical directories is to visualize 
an upside down tree. The main or starting directory, which every 
djsk has is called the root directory. The root direliory can hold 
files or additional directories, called subdirectories. Each subdirec 
tory is like a tree branch. While a disk can have only one root di- 

b^Z.T^^ 8 ****** can hold » additional 
branches (subdirectories) as you like (as long as the disk has enough 
free space to hold the additional directories). Because every sut 
directory can trace its ■Heritage" back to the root directory,? hier- 
archy of directories is established 



mailing usr 



Quickly finding a specific file in this list would not be easy. And if 
this disk had 50 files, finding one mrti^Ur fii~ ' _ 



Word Processing dir 
WP Program 



Term Paper 
Graphics.dir 
Draw Machine 
Picture 1 
Picture 2 
Picture 3 
Data,dir 

Database ® ^^vcswj rj 

Financial Data jjj .. 

Mailing List 

*es that represent^ r^ons of ^ ^ **> ^ 

a subdirectory to store those nlL Yrf ^ States c «*te 
^ 86 ^ Your «««d list would look like 

Word Processing.^ 
WP Program 

Essay 

Term Paper 
Graphics, dir 
Draw Machine 
Picture 1 
Picture 2 
Picture 3 
Data dir 

Database 
Financial Data 
Mailing.dir 
South 
North 
East 
West 

<™l «- on your disk to 
how you migft, o^**^^*" X» have an idea of 
subdirectories are you wSTooklrT ^" 3 r00t direa °<y »d 
nipulate directories * how >™ c » create and ma 



Using the DIR Command 

The simplest way to list a directory is to type DIR and press RETURN 
The system then displays the names of the files and subdirectories 
in die directory you are working with. As is the case with almost 
afi AmigaDOS commands, the DIR command has a number of var- 
iations. They are as follows: 

DIR <directory-name> 

If you want to list the files in a specific directory, use this format 
.cr example, to list the names of files stored under Music Progs' 
you type DIR Music.Progs. Remember that listing the files in a main 
directory is not necessarily the same as listing all the files on a disk. 
To fist the names of files in a subdirectory, you type DIR and the 
subdirectory's name. 

DIR OPT A 

This format of the DIR command tells AmigaDOS "I want to list the 
DIRectory, and I want to exercise the OPTion to fist all the sub- 
directones » This command displays every file name on a disk The 
names of files stored under subdirectories are indented to show that 
they would otherwise not be on the main director/ list. 
DIR OPT D 

T^format fists only the names of the subdirectories on a disk For 

i> DIR fPT D 
Music. Progs (dir) 
Graphics (dir) 
Utilities (dir) 
i> 

DIR OPT I 

To display file names one at a time, use this format. A question mark 
appears after each file name, which indicates that Amig^OS is wat 
mg f ° r y0ur next comm ^- Here are the commands you can issue: 

RETURN Display the next file name. 

Q Quit the fisting. 

E Display the names of files in this dirertnry 

(Issue this command only if a directory is being 
displayed, of course.) 
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B Back up to the previous directory level. For 

example, if you are at the first subdirectory 
level, this command moves you up to the main 
directory level 

D Delete this directory if it contains no files. 

DEL Delete this file. 

T List the contents of this file on the screen. To 

stop the listing, press CTRL and C 
simultaneously. 

? Display the available options. 

The following example demonstrates the use of the DIR OPT I 
command: 

1> DIR OPT I 

Music. Progs idir) ? E <RETURN> 
Bach. Ras ? <RETURN> 
Rock. Bas ? ? <RETURN> 
B=BACK/5 ; DEL=DELETE/S; E=ENTER/S ; (HJJIT/S; B <RF-|JRN> 
Graphics (dlr) ? <RETURN> 
Utilities Cdir) ? Q <RETURN> 

i> 

What foUows is a sample session that demonstrates how some of 
the other formats of the DIR command are used. The semicolon 
^dentmes a comment, which the Amiga ignores. In the sample ses 
sions m th* chapter, use the information foUowing senSns for 
your own reference. The 1> is the AmigaDOS prompt wtoch n 
totes that the system is ready to recede the nextTommta 

1> DIR; this is the "root" directory 
Music. Progs (dir) 
Graphics (dir) 
Utilities (dir) 
Amiga BASIC 

D ^Lchts^ 09 ^ U5tS ^ SUbdirect ^ M-ic. Progs 

Rock. Bas 
Shock. Bas 
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1> DIR OPT A ; this tells the computer to list all the fil 
Music. Progs (dir) 

Bach. Bas 

Rock. Bas 

Shock. Bas 
Graphics (dir) 

Cube. Bas . 

Perspect. Bas 

SinewavQ. Bas 
Utili: j ->s (dir) / 

Assem. 

Editing. Bas 
Hsxcode. Bas 
Amiga BASIC 



1> DIR OPT D 

Music. Progs (dir) 
Graphics (dir) 
Utilities (dir) 

1> ; end of sample session 

When you use the DIR command, keep in mind that you are not 
limited to only one series of subdirectories under the root directory. 
You can create as many directories within directories as the Amiga's 
memory allows. To move down to the next level of directories 
you use the slash mark (/). For example, if a subdirectory called 
MusicProgs (dir) had a subdirectory called Classics (dir), you could 
find out what files the Classics subdirectory contained by typing 

i> DIR Music. Progs/Classics 

The slash mark tells the system to move down one level from the 
MusicProgs subdirectory to the Classics subdirectory. 

You can specify the disk drive you are referring to when you use 
DIR (and many other AmigaDOS commands) by using the expres- 
sions dfO: and dfl:. These expressions specify disk drive zero (the 
internal drive) and disk drive one (the external drive, if you have 
one), respectively. For example, to display the directory for the ex- 
ternal disk drive, you type 

DIR dfl: 
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m 



T 



23 
23 
23 



02 
02 
02 



Using the LIST Command 

The LIST command is a sophisticated version of dtp tkt k „ 
displays information about files and Rectories on^L Jh V 
directory vou are mino tk- • r 5 on 1116 dnve and 

c n * 8 ' 71118 "formation includes the file** n, m , 

and size, any protection that the file mav haveTJ i £ * 
tune that the file was last revised U^^Z J^ "* 
the screen would display something 
1> LIST 

Directory cn Frid Feb . „ 
Music. Pn. tjj r 

Graphics ' al S;" 0 "" 85 21 

Music. Progs Dir ™" 23-Nov-SS 21: 

Amiga BASIC A ™ " at 21 - N °»-8S 21:.. 

Amiga BASIC info Ha r ™ 10 - Nar - 8S » ! BS'« 

nuuion about aB the flies SS*^™ * 
» contaauoo with the foUowing ^VZ^oZ^ ^ 
NODATES 

This option does not display the dut^ *w • 
were created. Here is an exan^ie ^ ^ mes 

1> LIST NODATES 

Directory »:•' on Frid Feb _ H _ 86 
Music. Progs Dir 
Graphics £ r ™ ed 

Music. Progs Dir rm 

Amiga BASIC rSat 
^^a BASIC, info rm ° nep 
2 fll.,-8 directories-170 b^Rs 47 

SINCE <date> 

This option displays the files created since the ^ 
can specify the date in a nnmh^f Smcc * hc y° u specify. You 
YY f 0rrnat , by typ^th e d^f ,S ^ by ^ * ta DD MMM- 

by typing moTSZZ^lt WCCk (such 35 ° r 



i/>> anu press tun ukin, me comp uter tens you wmcn uirec L ory you 
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DATE DD-MMM-YY ' 

By typing DATE and the date (in the day-raonth-year format) you 
can set a new calendar date. The month should be the three-char- 

^ Cr ,?f Se! S!? 0n ° f dle m ° nth ' S naa * Feb > Ma *> Apr, May, 
eS/hfe' {** ^ ° f DeC) * ™ d ** 3nd should 

1> DATE 23-Aug-86 

^ ^ COrTeCt WCek but not corre ^ dav, you tjpe 

h^;^ C h ^ (f ° r CXam P le ' ^ ^«0- To specify 

either the day after or day before the current day you type DATE 
Tomorrow or DATE Yesterday, respectively. 
DATE HH:MM 

To s ,t the time, you type DATE followed by the hours and minutes 
(separated by a colon). If either the hour; or minutes is HE£ 
digit be sure to make the first digit a zero. For instance tftne toe 
-^03 ^ DATE 09.O 3 . After 12:59 p.m, you need to use ^ 
time the 2^.our system that adds 12 hours to hours after 12-59 
For example, 4:30 is 16:30 in army time. When you read thh 

2*255 S s p u mT 12 from ^ houre McLd (for - 

Displaying AmigaDOS 
Information 

cu^eTrf"! * e T° COmmmd t0 ^ formation about the 

^ ^7™^ m ^ y ° U lyVt ' ^ ^ ^een dis- 
plays the maximum size of each disk, the amount of used and unused 

TJS^t number of eiTOrs ^ have °^ ed - - d ^ 

1> 1^0 

Mounted disks = 

™* Ussd Fr " Ful > E""-* Status Nam. 

M. 88* 1425 333 81, B Rea ^ rlte Uorkbanch ^ 
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Displaying a Message 

You can use the ECHO command, which is similar to the PRINT 
statement in Amiga BASTC, to display information on the screen. For 
ciiample, you could use this command to display a message that 
notifies you that the computer has accomplished a certain task. Al- 
though this capability may not be useful to you right now, you will 
find it very handy when used within DOS command sequences. 
ECHO displays whatever yc:: -nter within quotation marks after the 
command. Here is an exan^ '**; 

1> ECHO "This is a test" 

This is a test 

1> 



Changing the Prompt 

With the PROMPT command, you can change the AmigaDOS 1> 
prompt. You type PROMPT followed by the new prompt in quotation 
narks. To switch back to the more familiar 1>, you type PROMPT 
"i> ". litre is a sample session: 

1> PRWT "Ready when you are -> " 

Ready when you are -> ECHO "11 ike my old prompt better" 

I I ike my old prompt better 

Ready when you are -> PROMPT "1> " 

1> ECHO "There we go" 

There we go 

i> 



Listing Files 

To list an entire file on the screen, you use the TYPE command 
followed by the name of the file: 

TYPE <file name> 

If you want the listing to include line numbers (1,2,34 ) you 
type 

TYPE <fiie name> OPT N 

/ 
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To print the file as hexadecimal numbers, you type 
TYPE <file name> OPT H 

The TYPE command is useful when you want to survey the contents 
of a particular file. Here are some examples: 

l>TYPESimpl e . Bas 

10 Rem This is one simple program 

213 Print "Testing" 

30 GOTO 10 



1> TYPE Simple. Bas OPTN 

1 10 Rem This is one simple program 

2 20 Print "Testing" 

3 30 GOTO 10 

1> TYPE Simple. Bas C°T H 



0010 
0020 
0030 
0040 



F5802200 m&Fm 54686973 20697320 

6F6E6520 736/6D70 6C652070 726F6772 

616D0030 110r^i40 AC202254 726F6772 

6E672200 maz-zm AC202254 

00000 



■ " This is 

one simple progr 
am. "Testi 

ng" "T.... 



Identifying Errors 



Two more AmigaDOS commands that provide you with information 
are WHY and FAULT. WHY tells you why the last error occurred, 
and FAULT tells you what specific error codes mean. Although 
AmigaDOS displays a brief message when something-goes wrong, 
you still may not understand why a command failed. The WHY com- 
mand provides a more detailed explanation of what went wrong. 
On the Workbench, an error code number is displayed when an 
error occurs. To find out what particular error code numbers rep- 
resent, you type FAULT followed by the error number(s). Look at 
the following examples: 

1> COPY HI TOBY 

Cannot open hi for input - object not found 
1>UHY 

The last command did not set a return code 
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i> FAULT 203 213 

Fault 203 : object already exists 
Fault 213- disk not validated 

i> 



Working with Diskettes and Files 

The sections that follow show you how to set up and rw ipulate 
the information stored on your diskettes so that you can manage 
the Amiga's disk storage better. You will learn how to format and 
name diskettes, how to create working diskettes, how to back up 
you dinettes, how to copy and rename your files, how to add com- 
ments to Sle names, how to delete files and directories, and how 
to merge and protect files. 

Formatting and Naming Diskettes 

When you purchase a double-sided, 3.5-inch diskette for your Amiga, 
the diskette won't work until you format it. With every microcom- 
puter that uses diskettes, you must format the diskettes in order to 
customize them to the computer's specifications. The command for 
this task is FORMAT, and you issue the command as follows: 

FORMAT DRIVE <drive number> NAME <diskette name> 

The drive number, either dfO: or dfl:, specifies the drive that contains 
the diskette you want to format. For example, to format the diskette 
in drive 1 (dfl:) and to name the diskette Disk two, you type 

i> FORMAT DRIUEDF1: NAME DISKTUO 

Before you use FORMAT, be sure that you do not need any of the 
information on the diskette you are formatting. Using FORMAT de- 
stroys all the information on a diskette. 

For the sake of organization, the name you give a diskette should 
be different from the names you give other diskettes. Names can 
have from 1 to 30 characters. If a name consists of more than 1 
word— that is if the name has any spaces— be sure to put quotation 
marks around the name, as in the following example: 
1> FORMAT DRIUE DPI: NAME "Music Disk One" 
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Creating Work Diskettes 

You already may have discovered that you can reset your computer 
with the CTRL and two Amiga keys only if certain disks are in the 
internal drive. Resetting the computer is called rebooting. With a 
disk such as Workbench, you can reboot the Amiga so that the Work- 
bench screen appears and you are ready to go. However, some disks 
suco as the Extras disk, won't boot without other disks. You must 
load the Workbench disk before you can insert the nonbootable 
disk. 

If you wsnt your formatted diskette to be "bootable" so that you 
don't have to insert Workbench before you can access the programs 
on the diskette, you can use the INSTALL command. You type 
INSTALL followed by tire nam- of the disk drive you are using (dft) : , 
dfl:, df2:, or df3:), and the Amiga does the rest For instance the 
following command makes the formatted diskette in drive 0 
bootable. 

1> INSTALL df0: 



If you are not happy with the name you have given z diskette you 
can use the RELABEL command to change the name. You type 
RELABEL, the number of the drive holding the diskette, and the 
diskette's new name. You have the option of preceding the drive 
number with the word DRIVE, and the name of the diskette with 
the word NAME Either of the following two command statements 
changes the name of the diskette in drive 1 to Newdisk: 
1> RELABEL dfl = "NQwdisk" 

1> RELABEL DRIUE dfi = NAME "Newdisk" 



Making Backup Diskettes 

One of the most important rales to follow when using any computer 
system is keep plenty of backups. If a diskette is destroved or dam- 
aged, and you don't have a backup copy of it, the information on 
the diskette is gone forever. So make a copy of each original diskette 

in case something goes wrong WtO! It. 
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To back up a diskette, you type DISKCOFY, the FROM drive number 
and the TO drive number. Remember that all the information on 
the diskette you are copying to will be erased. The information on 
toe diskette you are copying from will remain intact. Formatting the 
diskette you are copying to is not necessary; the DISKCOFY com- 
mand does that for you automatically. 

If you follow the entire DISKCOFY command with the word NAME 
and a name in quotation marks, the system assigns that name to the 
diskette you are copying to. Here are some examples of DISKCOFY 

COi^""»ds: 

1> DiW^Y (-HUM DF0 : TO DF1 : 

This command copies the information on the diskette in drive 0 to 
the diskette in drive 1. 

1> DISKCOPY FROM DF1 = TODF0: NfflE "Ml. ! c Backup" 
This command copies the information on the diskette in drive 1 to 
Backup tC ^ ddVe °' namCS diSkettC in ^ 0 Music 
i> DISKCOPY FROM DF0 = TO DF0 = 

This command copies the diskette in drive 0 to another diskette If 
you have only an internal drive, you use this command to back up 
your diskettes. The Amiga will guide you through the process of 
inserting your source and destination diskettes. 

Copying Files 

Jo copy individual files, you use the COPY command. This command 
copies a file or directory to another file or directory. If vou copy 
one directory to another directory, the system copies all' the files 
hi that directory to the other dir ectory. If you are copying only one 
file, the system copies it to whatever directory you Se Ssmg 

If you use the word ALL with the COPY command, the system copies 
all the files, including those in the subdirectories, to the directory 
you are working with. Here are some sample COPY commands.- 
1> COPY FROM Bach. Bas TO ^BachMusic 

^s coinmand makes a copy of the Bach.Bas program and stores it 
in the current directory under the name BachMusic. 
U COPY l-KOMBach. Bas TO ^MusicProgs/Bachflusic 



i^rr^ ^ a C ° Py ° f thc Bach Bas P^g^ and stores it 
in the MusicProgs directory under the name BachMusic. 

1> COPY TO df 1 : UTILITIES 

This command copies all the files in the current directory to the 
directory called Utilities in disk drive 1. 

1> COPY df0; TO dfl ; ALL 

^command copies all the fiies, including those in subdirectories 
from disk drive 0 to disk drive 1. S ' 

1> COPY dfl : todf0: ALL QUIET 

™ S C ? I ?"f nd c °P ies ^ files, including those in subdirecorie* 
from dxsk dnve 1 to disk drive 0. Because tie QUIET option Tu^d' ✓ 
the Arruga does not display each file name as *e sys^ c^iestt 

Renaming Files 

After you make a copy of a file or directory, you might want to 
change ,ts name. You might want to change a name for L~ 
^t Y ° U haVC -re WO p 8 riate Ze. You^S 

RENAME FROM <name> TO <name> 
The first ^ is ^ old namC) and ^ 
name. Here are some examples: 
1> RENAME 01 dname Newneme 

This command changes the file's name from Oidname to Newname. 
1> RENAME FROM 01 dname TO Newname 

^^^^ - «« — * * 

1> RENAME FROM Util i ties TO "Programmer Aids" 

This command gives fee directory called Utilities the new name 
Programmer Aids. Notice that because the new name coSisTof 
two words, quotation marks are used. S 0t 



Adding Comments to File Names 

You can add comments to file names in order to remind you of 

tTr^Ti, ^ rCViSi0n datCS ' P"***^ name, and other 
important fects. These comments can be displayed when you ex- 
amine a diskette's contents with the LIST command. To add a com- 
ment to a file name (which is displayed only with LIST not DlR ) 
you type HLENOTE, the name of the file, COMMENT, and tne coS 
ment. Use quotation maris around any comments that include 
spaces. Here are som? examples: 

1>FILBCTE Shock, Bas-^r -.-his is so, e pretty shockin* 
i> FILENOTEHsxcode. Bas COrtENT Translator 

Ti^ L f^ F i LEPerSPBCt BaS ' V * r5i ™ 3 - 6 by 

Tim Knight - draws a perspectiue in many colors" 

Notice that quotation marks are not used around the comment ir 

Deleting Files and Directories 

ll ******* >™ no longer need (and to free 

up valuable disk space), you use the DELETE commai.d DELOT 
has a vanety of options that make it very flexible- thT 
to use the command is to type D^^nZ ^ZZl 
you want to erase. You can delete as many as 10 fl£ at a ttL " 
lon g as you use spaces to separate each file name For exam^e If 
MusicProgs is your current directory, you can use tne ^ P 
command to delete all three ofZVZ^^J^ 8 
1> DELETE Bach. Bas Rock. Bas Shock. Bas 

m o ^ * ""cctorj itseii. Lhat is, you cannot use the DELETE mm 
mand to erase a directory if the directory contains prograS 

TulTn™** 1 * 1 y ° U <*" USC Wth DELETE ALL which deletes 
aU the files in any subdirectories, and QUIET, Xc^^ Z 
computer lrom displaying any fiie(s) beine deleted 
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i> DELETE dfi = ALL 

This command removes all files in subdirectories on drive 1. 
1> DELETE df 1 = ALL QUIET 

This command does the same thing as the preceding command but 
does not list each file being deleted. 



Merging Files 

Sometimes you may want to combine several files into one ... -.ex 
file. Suppose that you have two text files called Act 1 and Act 2, 
and you want to combine them into a new file called Play. You type 

1> JOIN "Act 1" "Act2"ASPlay 

You can combine as many as 15 files to create a new file. Be sure 
to type the word AS before the new file name. 



Protecting Files 

When you use the LIST -^remand to examine files, you will notice 
a single character just before the date. That character indicates the 
file's protection status. Most files will have an r before them in- 
dicating that they can only be read. The file protection status symbols 
are the following: 

r The file can only be read. 

w The file can only be written to. 

The file can only be deleted 

9 The file can only be executed. 

PROTECT is the command that gives a file a specific protection 
status. You type PROTECT, the file name, and the protection status 
character(s). If you omit one of the protection status characters, 
the system knows not to perform the action that die missing char- 
acter represents. Suppose that you type 

1> PROTECT Editing. Bas rwd 

These status characters make Editing.Bas a file that can be read, 

written to, or deleted, but not earned. However, Suppose that you 



1> PROTECT Editing. Bas rue 
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The d option is not included in the status characters. Therefore, you 
cannot accidentally delete Editing.Bas. 

Moving Beyond the Basics 

This chapter has examined all the commands that you need in order 
to back up disks, copy programs, protect your files, and perform 
simple DOS operations. If you are satisfied that these AmigsDOS 
commands are all you need to know, go on to Chapter 10 to —id 
about different uses for your Amiga. However, if you want to get 
involved in the more complex task of creating the AmigaDOS com- 
mand sequences that make the system perform functions for you 
automatically, then read the next chapter carefully. That chapter 
describes many of AmigaDOS's more powerful commands. 



Advanced AmigaDOS 



When you first begin using a computer, you «L'ay think that it is 
operating at maximum efficiency and that "keeping up" with such 
an amazing machine might be a difficult task Howe v. r, as you be- 
come more experienced at using a computer, you ma; t egin to think 
that it is lagging behind you. 

The problem isn't in the machine's capability to process commands; 
many computers, including the Amiga, operate at very high speeds' 
The problem is that if you type DOS commands one at a time ana 
use the same sequences of commands frequently, you might begin 
to think that DOS is an inefficient way to communicate with a 
computer. 

You can increase DOS's efficiency with command sequences. Com- 
mand sequences are an ordered series of commands that the com- 
puter carries out after receiving a couple of command words through 
the keyboard This chapter on advanced AmigaDOS commands ex- 
plores windows, command sequences, and other AmigaDOS features 
that can increase efficiency. 

Using Multiple Windows 

In AmigaDOS each window is independent of the others, so you can 
run different pr ograms and functions simultaneously by moving from 
one window to another. You just point the mouse to whatever win- 
dow you want to work with and press the left mouse button. 
To «p P n a r , m - yWM the NfAYGLI cuinmand. Tuu L4U 

customize an AmigaDOS window by giving it a name, moving it, and 
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changing its size. You can make these specifications by using the 
following format of the command: 

NEWCLI CON:<x-coordinate>/<y<oordinate>/<width>/ 
<height>/<title> 

For example, you could type 

1> NBJCLI CON:10/30/60^0/"Number Two" 

A new window appears with its upper left corner at ( 10,30), a width 
60 pixels, and a height of 50 pLxels. The name Number Two appears 
■t 'he t ^ of the window (Remember to put quotation marks around 
the mi^c u it includes spaces.) ( &rfUAS) 

To get out of an AmigaDOS window, you type ENDOJ If you have 
only one window left, ENDOJ exits AmigaDOS, so be careful when 
you use this command. 

Building Command Sequences 

The following sections introduce commands that you can use to 
build command sequences that will increase AmigaDOS's efficiency, 
^ou will learn the commands for AmigaDOS's built-in editor the 
special AmigaDOS commands for sequences, and the command for 
decision-making with AmigaDOS. 

The Editor's Commands 

AmigaDOS has a built-in editor that you can use to create text files 
Although describing the editor in detail could fill a book in itself 
this section provides the basic information that you need to know 
in order to create files. 

To create a file, you type ED followed by a file name. For example 
if you type ED TASKONE, the system creates a file called TASKONE 
and accesses the editor immediately. Then you can go ahead and 
type your text. 6 

Once you have accessed the editor, you can use all of the following 
commands: & 

Cursor keys Move the cursor up, down, left, or right 

BACKSPArP De l etes the last chancer typed 
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RETURN 

TAB 
CTRL-A 

CTRL-B 
CTRL-D 

CTRL-E 



Moves the cursor to the next line (below 
the one the cursor is presently on) 

Moves the cursor to next tab position 

Inserts a line (when you want to add more 
text) 

Deletes a line 

Scrolls ri.c text down (if you want to see 
text thai i«i ^irrtmly '-'above" the screen) 

Moves the cursor to the top or bottom of 
the screen. This command is a toggle, the 
first time you press CTRL-E, the cursor 
moves to the top of the screen, md the 
second time you press CTRL-E, the cursor 
moves to the bottom of the screen, and so 
on. 

Switches the case of the character on which 
the cursor is located. Uppercase becomes 
lowercase, and vice versa. 

Repeats the line that was just typed 

Deletes the last character typed; has the 
same effect as the BACKSPACE key 

Moves the cursor to the next tab position 

Deletes one word at the cursor's location 

Moves the cursor to end of the previous 
word 

Moves the cursor to «ne beginnine of the 
next word 

Scrolls the text up 

Redraws the entire screen 

Deletes everything from the cursor's 
location to the end of the current line 
A number of other commands also arc available through AmieaDOS', 

IX^™ y ' * e CUrSOf a ^ ears at * e bottom of the 

screen, you can enter any one of the following commands. After you 



CTRL-F 

CfRLG 
CTRL H 

CTRL-I 

CTRL-O 

CTRL-R 

CTRL-T 

CTRL-U 
CTRL-V 
CTRL-Y 
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enter the command, you must press RETURN in order for the com- 
puter to recognize the command. 

B Moves the cursor to the bottom of the file 

BF <"string"> Searches backward through the text for the 
string that you specify. For example, to look 
for the word ECHO, you type BF "ECHO". 

CE Moves the cursor to the end of the current 

line 

CL Mo, -s the cursor one position left 

CR Moves the cmsor one position right 

CS Moves the cursor to the beginning of the 

line 

D Deletes the current line 

F <"string"> Searches forward through the text for the 
string that you specify 

J J° in - : the line that contains the cursor with 

the following line 

LC Distinguishes between uppercase and 

lowercase when searching for a string. 
(Unless you use this command, the system 
doesn't distinguish between uppercase and 
lowercase characters; it simply looks for a 
particular sequence of letters.) You enter 
this optional command before you enter the 
search command. 

M <n> Moves the cursor to the nth line number. 

For^example, to move to line 5, you type 

N Moves the cursor to the beginning of the 

next line 

p Moves the cursor to the beginning of the 

previous line 

Q Quits without saving anything 

Splits the line at the cursor's current 
location 
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T 
U 



Saves text to disk 

SL <n> sets the left margin to position n , 

SR <n> Sets the right margin to position n 

ST <n> Sets the tab to position n 

Moves the cursor to the top of the fiJc 

Undoes changes made to the current Jfne 

UC Ignores differences in uppercase "nd 

lowercase when searching for sl ^<»s. Yea 
enter this command before you enter _ 
search command. 

x Exits the editor and saves the text to disk 

Commands for Sequences 

Although th editor has many uses, the scope of this chapter covers 
only how to use the editor for AmigaDOS. The material that follows 
shows you how to use the AmigaDOS commands with the editor 
to create a command sequence file, and then how to use that file 
as a way to issue many commands at once. 

The following brief example gives you a general idea of how a com- 
mand sequence file works. Access the editor by typing ED TESTER 
Then type the following: 

DIR 

ECHO "That' s all, folks!" 

-TsaTuSmf to Pfess X key to ° rder to cxit * c editor 

Now you have a file called TESTER diat covins the commands DIR 
fv!™°' To start securing the commands in a file, you use the 
EXECUTE command. In this case, you type 

DIR EXECUTE TESTER 

The system displays the disk's directory and, at the bottom of the 
screen, the message That' s al 1 folks! 

When you use the editor, you are not restricted to using only the 
AmigaDOS commands covered in Chapter 8. Other commands make 

AmigaDOS function like a simple programing language. 
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SKIP and LAB are two commands that you can use together in order 
to make the EXECUTE command skip to different parts of the text. 
For instance, suppose that you want to create the following text fi> 
called TEST2: 

ECHO "Ue' re going to start now" 
LIST 

CD :f1usicProj;s 
LIST 

SKIPOUERHERE 
DlSKCOPYdf0: to dfi : 
LAB OUEKHERE 
CD : 

ECHO " r m g lad we got around that DISKCOPY command ! " 

After you press ESC, X, and RETURN, the system saves this file as 
TEST2. Here's what would happen if you used this file with the 
EXECUTE command: 

i> EXECUTE TE5T2 

Ue"' re going to start now i 
(Tfeo Luting of the root directory would be here.) 
(The listing of the MusicProgs directory would be here.) 
I' m glad we gat ground that DISKCOPY command ? 

The CD ■■ command in the TEST2 file makes the system return to 
the root directory after executing the commands. You can enter any 
AmigaDOS commands in a file to EXECUTE. This procedure is an 
excellent way to put complex, frequently used routines in an easy- 
to-access file that you can run by giving one short command 

Here are four other sample EXECUTE files that you might find useful: 

1. This program places on the screen two new windows 
each with a different prompt. 

ECHO "Here are two new windows" 
PROMPT "2> " 

NEUCLI "CON: 40/40/200/50Alindow Two" 
PROMPT "3> " 

NEUCLI "CON; 150/106/210/100/Uindow Three" 
PROMPT "1> " 
ECHO "All done!" 
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2. This program changes the name of the diskettes in 
each drive. 

ECHO "The disk in drive one mil 1 be cal led DiskOne" 
ECHO "The disk in drive two will be cal led CiskTuio" 
RELABEL df0: "DiskOne" 
RELABEL dfl: "DiskTuio" 
ECHO "I'm done. " 

3. This program displays information about a diskette. 

ECHO "Full information for disk in drive zero=" 

LIST 

INFO 

ECHO "End of listinfl" 
UAIT5SECS 

4. This program forma- ;> diskette in drive 1, names it 
Music Backup, and copies the files from a directory 
called Music in drive 0 to drive 1. 

ECHO "Source^ Dr^ve 0/Be:!.i nation : Drivel" 
FORMAT DRIUE DFi = NAME "Musi c Backup" 
COPY DF0: Music TO DFI: Musi cALL UuilLT 
ECHO "Backup complete. " 

The kinds of files that you should concentrate on creating are those 
that contain command sequences that you find yourself using fre- 
quently. The purpose of the editor and the command sequences is 
to save you time when you perform routine DOS operations. 

Decision-Making Commands ' 

You may remember that Amiga BASIC uses the IF... THEN command 
to determine whether a condition is true or false and then act on 
that decisioa If you are programming a command sequence in 
AmigaDOS, you can use the IF command to check a condition and 
execute commands based on whether that condition is true or false. 
You can follow IF with any one of the following conditionals: 
WARN 

WARN checks to see whether the error mde number is 
greater than or equal to 5. For instance, if Error 103 occurs 
and a command sequence contains an IF WARN statement ' 
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then the system interprets the condition as true and 
executes whatever commands follow IF. 



ERROR 



ERROR does the same thing as WARN, except that die 
system interprets the condition as true only if the error 
code is greater than or equal to 10. 

FAIL 

FAIL works like WARN and ERROR, but checks to see 
whether the error code is greater than or equal to 20. If 
Error 14 occurs, the IF statement doesn't register that the 
condition was true. 

< "t-.yt"> EQ <"text"> 

The EQ keyword works with IF to determine whether two 
pieces of text art the same. The system checks only to see 
whether the le a-, correspond; it does not distinguish 
between uppercase and lowercase letters. Therefore, the 
system would interpret IF "AMIGA" EQ "amiGA" IF 
"TEST" EQ "test", zrA IF "Word" EQ "Word" as' true 
statements and proceed to execute the commands 
immediately following the IF statement. 

EXISTS 

EXISTS makes sure that a specific file exists. By following IF 
EXISTS with the name of a particular file, you can make the 
system check to see whether that file is on the diskette that 
you are Using. 

The IF command works with any of the preceding keywords in the 
context of a command sequence only. You can't use IF directh- from 
AmigaDOS. 

The IF command can take several different and useful forms The 
most basic way to use IF is to follow it with a condition and the 
word END IF. For instance, the following command sequence (which 
must be accessed through the EXECUTE command) checks to see 
whether an error code greater than or equal to 10 has been issued 
If so, the screen displays a message. 

IF ERROR 

ECHO "You blew it, Alfalfa. " 

CHD1F 
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You use the ENDIF statement to tell the system where the IF part 
of the sequence stops. If the condition tested is false, the system 
executes all the commands between IF and ENDIF. Therefore, you 
will want to be sure to put an ENDIF after the condition being tested, 
at the place where you plan to resume the command sequence. Here 
is a simple rule that you can follow: Type ENDIF in your command 
sequence after you type the commands that should be used if a 
condition is true. The format for this kind of sequence is as follows: 

IF <X >«Kiitk,n being tested> 

<comman^ v> be executed if the condition is true> 
ENDIF 

The IF...ELSE...ENDIF sequence is somewhat more complex. Like the 
IF... THEN... ELSE in Amiga BASIC, this sequence tells the system to 
execute certain commands if a condition is ;me and to execute 
others if a condition is false. If a condition is true, the system acts 
on the commands between IF and ELSE. If th> condition is false, 
the system executes the commands between ELSE and ENDIF. For 
instance, the following routine determines whether a file called 
Term Paper is on a diskette. 

IF EXISTS Term Paper 

TYPE Term Paper 

ECHO "That was quite a paper 1 " 

ELSE 

ECHO "Keep looking. " 
ENDIF 

If Term Paper is on the diskette, the system types the whole file 
and displays That was gu i tea paper !. If the file is not on the diskette 
the screen displays Keep looking. 

You can use more than, one IF in a sequence. Just like nested 
FOR.. NEXT loops, nested IF...ENDIF (or IF...ELSE...ENDIF) state- 
ments can be useful in complex routines. When two IF...ENDIF state- 
ments are nested, the first IF refers to the last ENDIF, and the second 
IF refers to the first ENDIF. This arrangement may be confusing, so 
here is an example to show how it works.- 

IF EXISTS "Santa Clara" 
IF EXISTS "University" 

ECHO "The files SANTA CLARA and UNIUERSITYare both on this 

diskette. Conoratulati one 

ENDIF 

ENDIF 
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The program checks to see whether the file called Santa Clara is on 

SL™ ^ * e ^ * n0t f ° Und ' P 10 ^ raoves P** the last 
ENDIF statement (the one that corresponds to the first IF) and ig- 
nores everything that was skipped over. However, if Santa Clara % 
on the diskette, the program jumps to the next IF statement to see 
whether University is also on the diskette. If the file is not found 
the program skips to the first ENDIF, proceeds to the second ENDIF 
and then executes whatever follows. If the file named University is" 
found, the screen displays the message following the ECHO 
command. 

Making Errors Useful 

When a command sequence is running, an error may occur that 
could cause a problem. Some eras nre so serious that the sequence 
should stop running so that you can find out what's wrong Other 
errors might not be important for a particular sequence. 

To tell the system to exit a command sequence if errors occur vou 
use the FAILAT command. FAILAT, wher T followed by a posSve Z 
teger, tells AmigaDOS: "Get out of this con^and sequence if you 
encounter an error with a code greater than or equal to the number 
following FAILAT." Suppose that you put the following at tTbe- 
ginning of a command sequence: 

FAILAT 15 

This tells the system to stop the sequence if the system encounters 
error 15, 16, 17, and so on. But if the system encounters error U 

should n" sTop^ ClSe 3 C ° dC 1CSS 15 ' * e 

If you type FAILAT without a number, the system tells you what the 
current "tolerance level" is for errors. The initial value is 10. There- 
fore, if you want the command sequence to stop based on a different 
error code level, you should use FAILAT with a specified number. 
A command that you can use with FAILAT is QUIT. QUIT prints the 
error code that you specify if the command sequence encounters 
an error. For instance, the following program checks to see whether 
any errors occur that have a return code of 25 or greater If the 
system encounters an error, the system stops and displays error code 
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FAILAT25 
IF ERROR 
QUIT 20 
END IF 



QUIT, which is similar to the END statement in Amiga BASIC stops 
the command sequence immediately. If you do not follow QUIT with 
an error code that you want displayed, the system stops the com- 
mand sequence and does not display any error code. 

Searching for Text 

To find a particular piece of text on a diskette, you do not have to 
look through all your files with the TYPE command. A much more 
efficient method is to use the SEARCH command, a built-in 
AmigaDOS function. SEARCH examines the files on a diskette « " 
tu*cl7 ^ ^ ** C ° ntain the text ^u specify. 

teTsM R ?H T f St T iSh bCtWCen UpperC2Se ™ d lowerc ^ In- 
ters, SEARCH displays the text regardless of its case. 

You can use several different formats with the SEARCH command 
The simplest way to search is to type SEARCH followed by the text 
you are looking for. If the text consists of more than one word (tS 

SFA»™ 3 S 51 Ce> ' PUt qUOmi0n marks a**"* the text. 
The SEARCH command by itself checks only the files in the directory 
that you are working with. If you type SEARCH and you type ALL 
after the specified text, the system searches the entire diskette 
Here are some examples of the SEARCH command: 
SEARCH 37500 

^command looks for the number 37500 in the files in the current 
SEARCH "37500 dollars" ALL 

This command looks for 37500 dollars in every file on the diskette. 
To examine the diskette in a particular drive, you use dfo: or dfl- 

2S^T* 1 cthe extemaJ drive) for * * ^ 

SEARCH dfl: "CompilQr" ALL 
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Making the System Pause 

Whether you are using the editor or working with AmigaDOS alone, 
you can make the system pause by using the WAIT command. This 
command stops the system for a specific amount of time or until a 
particular hour. Here are the various formats you can use with the 
WAIT command: 

WAIT <number of seconds you want the system to pause> 
SEC 

WAIT <numiu-.- of minutes you want the system to pause> 
MIN 

To make the system wait until a certain hour, you type 

WAIT UNTIL <the hour> 
Here are three examples: 
UAIT5SEC 

This command makes the system pause five seconds. 
UAIT3MIN 

This command makes the system pause three minutes. 
UA IT UNTIL 20 = 30 

This command makes the system wait until 8:30 p.m. 

After you begin forming patterns in the way in which you use 
AmigaDOS, you will probably know what kinds of self-executing files 
you should create to save time. For example, WAIT is useful in a 
sequence that displays information on the screen and then pauses 
to give the user time to read the message. 

Making AmigaDOS Work for You 

AmigaDOS gives you much flexibility in the handling of the infor- 
mation stored on your files and diskettes. You should study and use 
the operating system commands carefully at first because, if used 
incorrectly, they can ruin your diskettes. As you become more ex- 
perienced with AmigaDOS, you will find many new doors open to 
you. Using the features of AmigaDOS, you can explore assembly lan- 
guage programming, perform complex file manipulation tasks, and 
protect your diskettes and files from damage and unauthorized use. 



10 

Amiga at Work and Play 



Now that you are nearing the end of this exploration of the Amiga, 
you can begin to reflect on what you have learned. You have seen 
how to program in Logo and Amiga BASIC, and you have studied 
the fundamentals of the C language. You also have taken a thorough 
look at the graphics and sounds capabilities of the Amiga. 

All this knowledge is good because it helps you better understand 
the potential of the Amiga. However, if you stiU are asking yourself 
the question "Whit goud is my computer?" this last chapter should 
help you find the answer. This chapter investigates that question by 
exploring what the Amiga can do to make your life easier, more 
productive, and more enjoyable. 



Word Processing 

One of the best ways you can use any computer is for word pro- 
cessing. A word processor is a computer program with which you 
enter, print, and save text (such as letters, resumes, and even chap- 
ters for a book about the Amiga). You can think of a word processor 
as a magic typewriter: you can alter, add, delete, and enhance text 
as you like until you are ready to have the computer print the final 
version on paper. Naturally a word processor can perform all the 
regular functions of a typewriter: you can type words and numbers 
from the keyboard and get a printed copy (hardcopy) when you 
are finished, just as you can with a typewriter. 

The advantage of word processing on a computer is that while you 
are typing, nothing is actually printed on paper, Because your WOrOS 

are electronic, you have all the advantages of electronics. You can 
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erase letters and words, move blocks of text, save and retrieve your 
text files, print the text in special typefaces, and do all sorts of other 
tasks that are difficult or impossible with a typewriter. With a word 
processor, you can happily throw away your correction fluid. A word 
processor can perform the functions of a typewriter so much better 
than a typewriter that you will wonder how you ever got along 
without a personal computer in the first place. 

The word processor that Commodore-Ai/tiga offers is Textcraft® 
from Arktronics Corporation (520 Easi liberty Street, Ann Arbor, 
MI 48104). This package has a fist pnc f *9£ i>id should be avail- 
able at an Amiga dealer near you. 1 Textcran is "specially easy to 
learn because it provides help throughout the program; 21 different 
1 -minute tutorials help you get out of any jam. Note, however, that 
the program is slow in loading the different features. 

The real power of Textcraft is that it performs all the formatting 
functions for you. When you start Textcraft, you can choose one of 
the ready-to-use templates (the forms in which you can create docu- 
ments), or you can instruct the computer to start with a blank form. 
Textcraft will align the addresses properly in a business letter, give 
you space for bibliographies in a term paper, or emphasize certain 
parts of yew resume. In short, Textcraft handles the framework so 
that you can concentrate on the content of your document. 

Textcraft consists of six templates: a business letter, a memorandum, 
a technical report, a business report, a term paper, and a resume. 
Each template provides considerable "hand holding" that makes the 
program easy to use. The resume form, for example, lets you enter 
your name, address, the style of the resume you want (chronological, 
analytical, or functional), and your preference as to whether your 
resume should emphasize your education or your work experience. 
On the business letter template, you enter the form of address (such 
as Mr., Mrs., Ms., or Dr.) for the sender and the recipient; the names 
and addresses of the sender and recipient; the typist's initials; the 
date; the recipient(s) of any carbon copies; the format (full-block 
or semi-block); and the number of enclosures, if any. The term-paper 
template even has a special screen devoted to the title page; the 
prompts request such information as the title of the report, the sub- 
title, the name of the student, the date, and the course name. These 
quality templates, which few other word processors contain, make 
the software a very good value. 



1. Prices given in this chapter were correct at the time the book was written, but 
may be subject to change. 
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With a word processor, you can alter, add, delete, and enhance text 
to your liking until you are ready to have the computer print out 
the final version on paper. Here are some of the features of the 
Textcraft word processor that can help you perform these tasks: 

Insertion: To add an extra character, word, sentence, or 
whole section of text, you can move the cursor to the 
desired point and insert the text. As you insert the extra 
text, the rest of the document moves over to make room 
for the additional information. 

Deletion: If you get rid of part of the document (even just 
one character), the word processor keeps the rest of the 
document looking as good as it was before. 

Search and Replace: Suppose that you have a 10-page 
document and you realize that you may have misspelled the 
possessive pronoun &s as it's. Because you don't want this 
all-too-common error marring your paper, you can tell the 
computer to search for the word it's. The program will go 
to the first occurrence of it's and stop. You also can 
instruct the computer to search for certain pieces of text 
and replace them with the new t~xt. In this case, you could 
tell the Amiga to change every it's to its. When you are 
searching and replacing or simply searching for text, you 
can specify words, sentences, or any text up to 255 
characters long. 

Block Moves: You sometimes may decide that a block of 
text would be more appropriate in another part of your 
document. Textcraft lets you remove an entire block of text 
and place it somewhere else. 

Formatting: To make your document look just the way you 
want, you can change the spacing and alignments, center or 
justify the text, switch from 60- to 80-column mode, 
number pages, and change typefaces (such as bold, italic, 
underline, superscripts and subscripts, or any combination 
of these). The term justify simply means that the right 
margin of the text, as well as the left, is even rather than 
ragged. You may notice in magazines and books that the 
text is justified; that is, both edges of the text are lined up. 
The computer justifies text by adding space between words 
so mat all tne lines are tile same length. Justification of text 
can help you achieve a professional look 
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File Commands: One of the most important advantages of 
using a word processor is that you can save and load your 
files. If you ever have turned in a long paper or mailed a 
letter that was later lost, you will understand how Suable 
this feature is. With a computer, you can load the old file 
back into memory and print the document again. 

Another advantage of being able to save and load files is 
that you can modify and enhance a document easily over as 
long a period of time as necessary. To do so, you n~ed only 
to load the file into the computer when you are ready h 
work with that document. This high-tech advantage has a 
flip side, however, because a computer can just as easily 
"eat" a document by "bombing" when you are in the 
middle of typing something or by malfunctioning and 
perhaps destroying more than one of your disk files. The 
way to pro* -ct yourself against these kinds of catastrophes is 
not only cg save frequently as you go along, but also to 
keep backup copies of diskettes that contain documents. 
This point cannot be emphasized enough; remember this 
and you can avoid losing valuable files and many hours of 
time. 

Textcraft makes excellent use of the Amiga's windows, color graph- 
ics, and mouse. The cursor keys move the cursor around the docu- 
ment; and when used with the SHIFT key, they move the cursor to 
the corresponding edge of the screen. The function keys can be 
used to indicate that you need help or to select certain Preferences; 
function keys F5 through F10 are represented by icons. Table 10.1 
lists the function keys, their icons, and their functions. 



Table 10.1 
Textcraft Function Keys 



Key 



Icon 



Function 



F5 
F6 
F7 
F8 
F9 
F10 



Pencil 
Scissors 
Camera 
Paste Jar 
Paint Brush 
Style Brush 



Change the format of text 
Chanae the type style 



Move the text cursor 



Delete text 
Copy text 
Paste text 
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Word processing is an outstanding use for any personal computer, 
especially for the Amiga with its easy-to-use Textcraft word- 
processing program. Even if you type just a few letters a month and 
a long paper now and then, a word processor is well worth the 
expense. You will be amazed to find out how efficient you can be. 

Telecommunications 

Ti '?rom,nnnications is the system in which computers send and 
receive _j f ormadon to and from other computers by means of an 
ordinary telephone. For personal computer owners, this capability 
means that a wealth of information, news, and friends are within 
your reach. 

To communicate with the outside world, a computer needs a device 
that connects the computer to a telephone This device is called a 
modem, and with it you can communicate idi other personal com- 
puters, large mainframe computer databases, and nationwide bulletin 
board services. 

The rate at which you can send and receive information with your 
modem is measured in binary digits (bits) per second. If your mo- 
dem can send or receive a certain number of bits within one second, 
the modem is operating at that particular baud rate. For example, 
a modem that transmits 1,200 bits every second is a 1200-baud mo- 
dem, and 2,400 bits per second transmission is possible with a 2400- 
baud modem. 

The modem available from Commodore- Amiga, the 1200 RS®, is a 
1200-baud modem that sells for $395. A more sophisticated device 
is the T-modem™, which sells for $695 from Tecmar (6225 Cochran 
Road, Solon, OH 44139). A T-modem can operate at 300, 1200, or 
2400 baud and features a sophisticated design that is appropriate 
for business users. 

Communications with Other 
Personal Computers 

Before you decide whether you should purchase a modem for your 
Amiga, you would be wise to consider the possibilities that are avail- 
able with a modem. One wujr to uac a modem ia to communicate 
directly with another personal computer owner. You "chat" with 
each other by typing on your keyboards, and you can send and re- 
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ceive public domain programs. Public domain programs are pro- 
grams that are legal to distribute to others; these are unlike 
copyrighted programs, which should be purchased in a store. (Il- 
legally selling or giving a copyrighted program to someone is called 
software piracy. That topic is examined later in this chapter.) 

The process of electronically sending and receiving information is 
not complicated. The host computer (the one sending the infor- 
mation) transmits information to its modem. The modem then trans- 
its the characters, letters, symbols, and other information into a 
t*ir4i sound composed of pulses that represent the bits of infor- 
li-.. : ->n being transmitted. This sound is sent over the telephone line, 
which Keeps the signal intact until it reaches the modem receiving 
the information. That modem then translates the sound back into 
the characters, letters, z\ A symbols that appear on the screen of the 
computer receiving the information. 

Bulletin Board Services 

A computer that is equipped with 3 modem can communicate di- 
rectly with any other computer that has a modem. However, most 
people involved in computer communications prefer to call bulletin 
board services or large mainframe databases like The Source SM or 
CompuServe®. 

A bulletin board service (BBS) is usually just a personal computer 
equipped with a modem and special software. Unattended by an 
operator, the service receives calls and serves as a host to whoever 
is calling. A BBS can store and retrieve messages, upload (receive) 
and download (send) programs, and do just about anything else 
involved with the transmission of data from one computer to 
another. 

Calling a BBS or any other system is simple enough: you dial the 
number, wait for the high-pitched tone, then switch your modem 
to "receive." At that point, data will begin appearing on your screen. 
This information will tell you where the BBS is located, who the 
system operator (SYSOP) is, and what the bulletin board's purpose 
is. A menu then will appear on the screen. Table 10.2 lists and 
explains some of the frequently used menu options. 

Bulletin board services are located all over the United States. Table 
10.3 gives the telephone numbers of some DD5i 111 IIIHJOT CHICS. One 
of these is probably relatively close to you. By using the command 
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Letter Option 



B 



G 
H 
O 
R 



Bulletins 



Download 



Enter 

a message 



Table 10.2 
BBS Menu Options 

Result 

Displays the bulletins currently on 
the system. Bulletins, which are 
entered by the SYSOP, announce 
club meetings, birthdays, special 
even's, and so on. 

Allows you to retrieve a program 
from the BBS. You can save the 
program on a disk for iatrr use. 

Leaves a message for everybod/ 
(ALL) or for one person. A message 
to ALL can be read by anyone, bu m 
message to a particular person is 
accessible only to that person, who 
will be "flagged" (notified that a 
message is waiting) the next time the 
person logs on to the system. 



Goodbye 
Help 

Other systems 

Retrieve a 
message 

Summarize 
messages 



Talk with 
SYSOP 



Tells the host computer you want to 
hang up 

Accesses BBS instructions on how 
to use the system 

Displays the telephone numbers of 
other systems 

Lets you get a message aHdressed to 
you or a series of messages 
intended for everybody 

Displays the whole library of 
messages and their subjects so that 
you can scan the list to decide what 
messages you want to read 

Allows you to send messages to the 
SYSOP and read what is typed back. 
This sort of conversation is great 
typing practice and, although slower 
than talking, is a great deal of fun. 
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U Upload Gives the system a program for its 

files 

X Expert user Makes the system recognize you as 

an expert user who can be given 
very brief commands instead of long 
descriptions. Use this command after 
you are confident about using the 
BBS and its commands. 



that will print out c- * ° r sy^ms' phone numbers, you probably can 
find quite a few bulletin i>cs-ds near enough to keep your phone 
costs low. On some BBSs, all 1,500+ systems are Listed, but probably 
about 15 percent of these are no longer around or have changed 
their phone numbers. 



Table 10.3 
Locations of Some BBSs 



City 


Phone 


Atlanta, Georgia 


(404) 953-0723 


Belmont, California 


(415) 595-5452 


(devoted to Amiga users!) 




Cambridge, Massachusetts 


(617) 354-4682 


Chicago, Illinois 


(312) 337-6631 


Dallas, Texas 


(214) 634-2668 


Denver, Colorado 


(303) 759-2625 


Houston, Texas 


(713)977-7019 


Los Angeles, California 


(213)349-5728 


Manhattan, New York 


(212) 245-4363 


Miami, Florida 


(305) 821-7401 


Portland, Oregon 


(503) 646-5510 


San Francisco, California 


(415) 552-8924 


Shreveport, Louisiana 


(318) 631-7107 


Washington, D.C. 


(703) 281-2125 



Bulletin boards are an inexpensive way to have fun with computer 
communications, as long as you are calling local services. You can 
make friends with the SYSOP and with the regular users of the sys- 
tem, get some good public domain software, and establish an effi- 
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dent "mail system" with other modem-equipped computer users. 
Remember, though, that long distance calls and "message units" for 
calls to locations in your area code quickly can make this pastime 
an expensive one. 



The Source and CompuServe 

To make more practical use of your modem, you can try one of the 
large systems that offer newspaper stories, airline schedules, the 
latest news and weather, research databases, and even mail-order 
catalogs on-line. These systems can be used by tm ,c smas of people 
at the same time and offer an enormous amount ot information, 
which you can access with your Amiga and a modem. 

These large systems have disadvantages, however. Some have start- 
up fees (like The Source at $100), and all charge for the time you 
are on the system, usually from $6 to $25 per hour. In addition, the 
response rate of large time-sharing services is usually slower than 
the response of a BBS because you are one of many people sharing 
the same system. Finally, the incredible variety of interesting features 
of these systems is enough to make most people burn more time 
and money on-line than they should. 

Generally speaking, however, these large systems are great fun and 
are very useful. One of the best is The Source ( 1616 Anderson Road, 
McLean, VA 22102), a subsidiary of the Reader's Digest Association, 
started in June, 1979- The Source has a great deal to offer in the 
following categories: 

News and Reference Resources: You can get the latest news, 
both local and national, from the United Press International 
service, and you can access information about government 
and politics, consumer information, science and technology 
reports, and even dining and travel information. 

Catalog Shopping: The Comp-U-Star service gives you access 
to 30,000 brand name items. Through your computer, you 
can order these items at 40 percent less than retail price. 
You also can use Barter Worldwide Inc. to trade items with 
someone else on the network. 

Mail and Communicatiom: Electronic mail and the "chat" 
mode, much like the message library and "talk to SYSOP" 
features of BBSs, are available on The Source. You also can 
mail messages to any one of the thousands of individuals on 
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the system, and you even can send electronic mail that will 
be printed on paper and delivered by the post office to the 
address you indicate. The chat option allows you to "talk" 
with dozens of people at the same time, making for some 
lively conversations. 

Business and Financial Markets: With this service, you can 
get the latest stock quotes, commodity prices, and interest 
rates. The service also has a research and reference section 
along with a news and commentary section to assist 
investors in researching places to put ukW money. 

Home and Leisure.- Blackjack, Adventure, uc>T*c-Toe, and 
dozens of other games are available on the network ' 

Education and Career: You can educate yourself with 
lessons in Greek, French, poetry, spelling, grammar, and 
other subjects. The service also provides information on 
education and careers to help you with college and job 
decisions. 

Computer Languages.- One advantage of being on-line with 
an enormous computer system like The Source is that you 
have access to many of its powerful languages and utilities. 
This section of the system lets you create programs using a 
variety of high-level languages. As powerful as the Amiga is 
you still may want to experiment with other systems that 
have even greater capabilities. 

Source Plus: Many business and educational journals are 
available electronically. A few of these are Forbes, Harvard 
Business Review, and Venture magazine. 

For those who can afford the charges (14.50 to $20 per hour) The 
Source is a powerful and interesting network 

Another system, with almost all the same features as The Source is 
CompuServe (5000 Arlington Centre Blvd., P.O. Box 20212 Co- 
lumbus, OH 43220). Although CompuServe doesn't have a start-up 
fee, its rates are $6 to $22.50 per hour depending on the time you 
call and the baud rate you use. The faster you transmit and receive 
data, the more expensive the service is. 

In addition to Source-like features, CompuServe has some extras that 
might interest you: 

The Multiple Choice (TMC). A g^t database will oak 
you questions on just about any subject you can imagine. 
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The CB radio: This is a sophisticated chatting system. Most 
people can get on a particular "station" (19, of course,' is 
the most popular) and send messages to dozens of people 
simultaneously. When you type something into your 
computer, everyone on that channel sees what you type; 
and you and all the other users can see anything that 
anyone else types. Sentences that you type appear on the 
screen one at a time so they don't get too jumbled. People 
come up with all sorts of weird handles such as 'Tm the 
Blue Knight." The CB is fun and can be addicting-and 
therefore expensive. If you want to have a conversation with 
one or more other individuals, and you don't want anyone 
else to listen in," you can go to private scrambled 
channels. 

Computer communications can be both entertaining and useful 
Once you have purchaser* modem and some software to support 
it, you are on your way t o going on-line with the world. You can 
have access to information that is not readily available to noncom- 
puter users. Also, you can expand the power of your Amiga by being 
in communication with different computers that have other features 
and languages. 



Computer Crimes 

Using modems with personal computers does have a "dark side " 
With all the power a modem can give to computer users, some 
misuse is inevitable. Modems provide the key to breaking into other 
computers, getting valuable telephone network information and 
acquiring a large library of software for next to nothing in cost Some 
people take advantage of technology by using phones' illegally or 
duplicating copyrighted software. Two particular types of computer 
cranes, which have attracted publicity lately, are largely the result 
of individuals abusing telecommunications; these crimes are soft- 
ware piracy and phone phreaking. 

Software piracy is the act of duplicating copyrighted software and 
gmng away or selling the copies. Often people make copies for 
friends without realizing that they are stealing from both the soft- 
ware company and program author, who aren't earning the profits 
they deserve from sales of the product. The estimate is that for every 

program .old, fl^ Uiegal CO pi« OlSirfDUieU. 
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Modems make the illegal exchange of software easy. Often this ex- 
change is simply a matter of either downloading programs from a 
"pirate" bulletin board service or getting programs over the tele- 
phone from someone you are on-line with. You can send software 
to BBSs or other people just as easily, and these exchanges occur 
constantly over the telephone lines of the United States. 

Tracking down software pirates who trade with friends, by mail, or 
with other individuals through a modem is practically impossible. 
However, the FBI has raided a number of bulletin board oc^ices 
that specialized in having copyrighted software avails > foi 
downloading. 

These bulletin boards also had information valuable to "phone 
phreiiks." The phreaks are an advanced kind of computer pirate; they 
abuse the telephone system with stolen codes and secret telephone 
numbers. By using Sprint and MCI numbers that are not theirs, find- 
ing WATS line .fibers, and stealing manuals and information from 
the telephone company, these people can make calls anywhere in 
the world for any length of time and not pay one cent. Some phreaks 
reach the point wttxe they can shut off phone lines or break into 
bank computers to alter information or transfer money to their own 
accounts. 

Fortunately, law enforcement agencies know considerably more 
about these crimes than they used to, and people who were "just 
having fun" are being fined and sent to jail more frequently for com- 
puter crimes. Remember that crimes with computers are illegal and 
are damaging to the businesses and the people affected by them. 
Getting involved with these activities can lead to much more trouble 
than the "fun" is worth. 



Business Software for the Amiga 

With the speed and memory of the Amiga, a business could be much 
easier to run with the help of this personal computer. The Amiga 
can work with the MS-DOS system, which is most commonly used 
with the IBM Personal Computer line. As a result, more than 1 1,000 
programs have been developed to work with the Amiga when it is 
equipped with the IBM Emulator. A sampling of these programs 
follows. 

Corporation: These products are the most popular business 
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software packages ever made for a personal computer. Hie 
Symphony package includes word processing, a database, a 
spreadsheet, telecommunications, and business graphics; and 
1-2-3 has all but the last two of these features. 

WordStar®: You can use this popular IBM PC word- 
processing program from MicroPro on your Amiga. 

ThinzTank"*; This program from Living Videotext helps you 
organize your thoughts and outline your plans so that you 
c; Priori! a task better. You can use Thinktank for 
writing a report, outlining a book, or simply figuring out 
what you have to do in the next week 

These and the thousands of other programs made for the IBM PC 
are all on 5 1/4-inch disks, so you need to purchase the 5 1/4-inch 
disk drive from Commodore. You plug in the data cable, just as you 
do with a regular Amiga external disk drivf , a.Kl load the Emulator 
program into memory. Although the Amiga is somewhat slower than 
the IBM PC at running these MS-DOS programs, the large amount 
of software available makes the compatibility an attractive option. 

Several other sophisticated business programs have been introduced 
for making business or job responsibilities easier to handle. Dc 
scriptions of some of these programs follow. 

Rags to Riches™ from Chang Labs (5300 Stevens Creek Blvd., San 
Jose, CA 95129-1088) will keep your ledger, receivables, payables, 
and sales in order by integrating the information from these four 
modules, which cost $99-95 each. The Ledger module keeps track 
of the income, expenditures, assets, and net worth of a company. 
With this module, you can determine where money is coming from 
and where it's going simply by entering the information requested 
into the various categories. 

Receivables is an automated billing system that will show the status 
of a customer account at the press of a key. You can charge and 
credit an individual's account, and the module handles wholesale 
and retail pricing, volume discounts, and tax calculations. The Re- 
ceivables module works with the Ledger to keep all your accounts 
current and in order. 

The Rags to Riches Payables module monitors your expenses. Pay- 
ables keeps track of vendor information, addresses, and terms so that 
you can make me Best use of cash flow. You can identify expenses 
by purchase order numbers, project codes, or job numbers, and you 
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can get a complete summaiy for any one vendor p,v.w . 

with the Ledger module. ^ bles ^ works 

total the amount sold in /, 8 ° nes tor merchandise, and you can 
centage £ *" ***** ^ P~ 

Ti.-* Maa^lc m r,S 3> f° USeS f0Ur to "=g«ted mod- 
the ote fifiJes^h^; w k Pr08fam automati cally updates 

munitions program l£ ^ * 3 teleCOra ' 

graphs on a printer With Tilt? P gnph5 and P 1 *"' *«* 

mation, yo^cTl^h , T m0dUleS starin 8 * c *"»<= "for. 
MaxiSharTLTJ mo S S < ^™' 0ad '" f0nnati0n ^* 
shea. inforrnaJr^M^c TZT°* * nd 
MaxiShare, and have Ma*rZ£ • m0thcr com Pmer with 
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Amiga can be a powerful business tool that can make runnine tout 
™ b 2r d0i0g yOUr ,ob "«*• * b « ™<* easier and 

Amiga Graphics Packages 

The best graphics package for the Amiga is Graphicraft® (see 
color fig. 101 in center o; book). TTte package, from Island Graph- 
ics of Sausakto, Caliform. .., s for U9S4 and is published by 
&mmodore-Amiga With Graphicraf, you can create pictures wrtt, 
up to 32 dtfferent color,. You can dxaw circles, rectangle,, and J£ 

G^T T y ° U CM * e «»* of brush *° - using 
Graphtctaft makes extensive use of the mouse as a drawing twf 

to the drawing board to do the actual drawing. 

At the top of the screen, the menu bar displays the opdons Proiect 

£55 '■ ° r ' ^ ^ BrUSh - Each "Pdon gives you a ™S 

of the menu bar appears a menu showing the 32 different colors 
and patterns available. Yon can alter the color and pS of ™ 
of these and choose one for your drawing You also can fo^ 3 
save your paintings for later reference. 

San£^ ° f """"I? CIaft To I» *™e idea of 

Graphictaft s power, here is a list of its capabilities: 

™r^ te ' Y ° U * te from &edland "tawing, 
rectangles, hues, curves, circles, arcs, triangles, ellipses 
pamllelogmms, and polygons. You also can fill ento areas 
with a certain color. - 

Tfetf available: You can type words and numbers in the 
drawing area in Topaz, Diamond, Ruby, Garnet, and 
Sapphire fonts; and you can put any of these fonts into 
plain, italic, bold, or underlined mode. 

mting features: You can erase, move pictures around, cut 
and copy pjeces of a picture, rotate a picture, flip it 
horizontally or vertically, or stretch it 

Colors and patterns: You can choose any of the 4 096 
colors, and yn U — pflttcm 

pattern editor. You also can change the brushes you draw 
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**** effects: You can draw repeating shapes, filled shapes, 
mvfihple shapes, and three-dimensional shapes You also can 
mirror- your drawing so that what you are drawine is 

Tf* t0 **** ° f * C foUr "*»» 
you select Finally, you can get the colors of a picmre to 

change m order to create the illusion of animation. 

SS^cSL^T r re . CaPaMitieS flMn * C Macintosh's 
MacPaint Commodore-Amiga's Graphicraft has unequaled feahves 
m developing pictures Not only is die program fiin to use Z Z 

Z tT P T7 f ta bUSinCSS P™U «*«3 «po^ 

and Anneal pi* ntag. Moreover, you can print die pictureTTd 
A^Kphfr " mmmenmb,C ,<>b ° f W «* potential of 

nf^T' I 9 ' DraW 3 ^nsive program ,L power 
of this package is that you can create the dfarfrtS 
supenmposing the picture firames you make. AlthoughT^ Draw 

nScesTel D C feamreS " GraphiCraft ' "* 
makes Aegis Draw even more fiin to use. 

Because the Amiga is such a great computer for graphics a numher 
of developers have undenaken die tremendous S of deveZta 
software that rakes advantage of these graphics. As time gS on 
;™ C,OPe,S m ^ <° ^-"even more J££ 



The Musical Amiga 

( ! Ws»w d on^ d Capabmiy l ° play four tones 

to the Amiga so that you can use it as a music machine. 

With the Amiga's MIDI interface, you also can hook uo foil blown 

^thes^ers to create a seemingly infinite variety 
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H S 10 2 Music Construction Set 
from Electronic Arts. 




Cherrvlane Technologies is the most active in developino musir,! 
apphcauons for the Amiga Harmony, one of the fSfXle pack 

MIDI mterfece not only to play music but also to teach rouTnl™ 
mus,c. On your Amiga, you can play along with one of fte so™, 

you can use the Amiga as your backup band. 

hZ,°7 fe r reS inCredibk **** *ow the sheet music 

C^ofmu^™ - - °- " 

The Entertaining Amiga 

Because the Amiga has such incredible sounds and graphics a fw 
m.cr 0proc md Iarge m manypeo^regard *e 

Amw as the most sophisticated game compute?^ hScS 

as v.-clL S " ^ entertaining and often educational 
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Electronic Arts (2755 Campus Drive, San Mateo, CA 94403) was 
one of the first companies to develop games for the Amiga. Elec- 
tronic Arts is recognized for its outstanding software, which has 
sophisticated graphics and astounding sound capabilities. These are 
some of the games being introduced by Electronic Arts: 

One-on-One": Dr. J and Larry Bird play a one-on-one game 
of basketball (see fig. 10.3). This is the most popular sports 
game ever written for a computer. You play the role of 
Larry Bird or Dr. J, and the computer plays the other man 
while the Boston Gaiden crowd cheers you on. 




Skyfox™: This program gives you the pilot's "eye view" from 
a sophisticated jet complete with radar. Your mission is to 
attack enemy jets and tanks. 

Seven Cities of Gold™: You learn history and geography as 
you play the role of Christopher Columbus seeking new 
lands. 

ArchorC*: This sophisticated board game is a mix of chess 
and Dungeons and Dragons. 

Deluxe Video Construction Sef: Computer graphics, 
animated scenes, sound effects, and titles are easy to create 

vi-ith this program. You even can record the routines on a 

videocassette so that you can watch them on a VCR 
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Arcticfox™: You are in command of a futuristic tank— the 
Arcticfox— and your mission is to defend the landscape. 1 
This game features amazing three-dimensional scenes and 
realistic sounds. 

Return to Atlantis™: In this three-dimensional simulation, 
you are an oceanic hero, Indiana Cousteau. 

Other Electronic Arts programs are Marble Madness™ (see color fig. 
10.4), which has the same amazing three-dimensional graphics as 
the pinball version, and Bill Budge's Pinhali Construction Set® (see 
fig. 1 0. 5 ), with which you can create your own t ^uivrized pinball 
games. 



Fig. 10.5. BUI Budge's Pinball 
Construction Set: software that 
lets you create your own games. 



<±0 ^ # ■ ^1 
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A number of other companies have introduced video games for the 
Amiga. For example, Synapse Software (Richmond, California) has 
come out with Mutant, Wyndwalker, Essex, and Brimstone, all of 
which are sold by Commodore. Although the video game craze of 
the early 1980s is long gone, the Amiga is still an outstanding way 
to while away the hours (hopefully not too many of them) in a fast- 
paced, entertaining way. 

Besides video games, some of the most popular entertainment pro- 
grams for personal computers are those from Infocom H25 Cam- 
bridge raiK unve, Cambridge, MA 02140). Founded by eight MIT 
computer scientists in 1979, InfoCom publishes a host of "interactive 
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fiction" games in which you solve murders, explore dungeons, and 
voyage into space. However, these games are not the simple "shoot- 
em-up" games known to most personal computer users. Infocom 
games are text-only interactive programs that are incredibly so- 
phisticated and challenging. No matter what problem you face in 
one of these games, you can rest assured that you will be hooked 
to the computer screen for hours (or days) trying to be a Sherlock 
Holmes, a Buck Rogers, or a noble knight 

The most interesting aspect of Infocom's software is that you can 
enter full sentences, and the Amig? usual'y will understand what you 
are telling it. In other adventure-type ^med, cnly two- or three- 
word commands, such as GO NORTH or GET I \MP, are accepted. 
In Infocom's software, however, sentences like HEAD NORTH AND 
GET THE LAMP THEN GO THROUGH THE DOOR will be under- 
stood by the computer, as long as you can head north and a lamp 
and a door do exist in the game. The parser in the games is the 
interpreter for the computer. Because English is such a complicated 
language, the parser will weed out the words that are not in the 
game's vocabulary or that are not used in one of the 300 sentence 
forms that the game can understand. 

The 16 programs are broken into the 4 genres of Infocom software: 
fantasy, mystery, tales of adventure, and science fiction. The games 
range in price from $39.95 to $49.95. Some of the games available 
are the following: 

Zork I®, Zork II®, and Zork III®: In this trilogy of games, 
you are a freebooter questing through the Great 
Underground Empire— a labyrinth dungeon with treasures, 
traps, and trolls. Your mission is to stay alive and collect as 
many treasures as possible before reaching the end of the 
game. 

Wisbbringer™: This game makes you a postal clerk with a 
temperamental boss, Postmaster Crisp, who gives you a 
mysterious envelope to deliver to the Old Magick Shoppe 
on the other side of town. At the Shoppe, you learn that the 
owner's cat has been catnapped by "the Evil One." When 
you leave, you discover that the whole town has changed 
and has become sinister and threatening. You have been 
told by the owner of the Shoppe, however, that a hidden 
stone named Wishbringer will grant you seven wishes to 
help destroy the Evil One and restore the town trt its 
former self. Of course, the Shoppe owner did not tell you 
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where the stone is because the Evil One will read your 
mind and get it for himself. The game even includes a' 
glow-in-the-dark "wishbringer stone." 

Enchanter®: You are an apprentice sorcerer doing battle 
with the Evil Warlock. While rinding your way through the 
enemy's stronghold, you have to figure out magic spells that 
you hope will come in handy later. 

Planet/all®.- As an ensign 7th class aboard the damaged 
spaceship Feinstein, you escape the exploding vessel and 
land on a decaying planet with a lost high-tech civilization 
Your mission is to save the planet with the help of a little 
robot named Floyd. 

Suspect": You are a journalist who has received an 
invitation to the annual Halloween party thrown by 
Veronica Ashcro* at her Maryland estate. During the party 
as you mingle and talk with other guests (your Amiga, 
actually), someone is murdered; and you are the prime 
suspect. You have to find clues to prove the identity of the 
real murderer while the other guests sometimes try to foil 
the mvestigatioa 

A Mind Forever Voyaging": For a real twist, this game puts 
you in the role of a computer. After decades of work, 
scientists have finally taught a computer to think like a 
chUd, slowly developing its intelligence and self-awareness 
When you (the computer) reach age 20, you are told of 
your true form and of the next phase you are about to 
enter. Your mission is to guide the United States into the 
year 2031 in the best way possible. This "interactive fiction 
plus game has a 1,700-word vocabulary and is a huge step 
forward in computer entertainment. 

Other games from Infocom are Starcross®, Cutthroats™, Hitchhiker's 

pended® A S?"' ™ e *W «- Sus 

pendedo^ All Infocom games are excellent, and if you would like a 

change of pace from the fast-action graphics and sounds games most 
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Other Languages 

To expand your knowledge of computer programming, you might 
want to try other programming languages available for the Amiga. 
This experience will not only increase your knowledge of computing 
but also will help you become a better programmer, because you 
will see the advantages and tricks used in other programming 
languages. 

You already have explored Logo and the C programming language, 
both of which are worthwhile to purchase and use Here are some 
other languages available for the Amiga: * nrj 

Pascal: This highly structured language from Metacomco 
(201 Hoffman Avenue, Monterey, CA 93940) is often 
recommended as the best way to start programming. 
Leai-dng Pascal is actually pretty difficult for the person 
who haj never worked with computers before, but after you 
have * tar? experience with C, you probably will be well 
prepared for Pascal. 

LISP: The learning Company's Logo has some of the 
characteristics of LISP, but this is a full-featured version 
from Metacomco. LTSP is recognized as the most popular 
language in the United States for developing artificial 
intelligence programs. 

Assembler: Also from Metacomco comes Amiga Assembler. 
Computers use three different types of languages.- high-level, 
which include Amiga BASIC, Pascal, and LISP (sophisticated 
languages that pack a lot of power into single commands); 
mid-level, which include the C programming language; and 
low-level, which is the category for assembly language. 
When you work with assembly language, you have to deal 
directly with the registers, memory locations, and other 
fundamentals. Although the Assembler requires many 
program lines to accomplish what a single Amiga BASIC 
statement does, the advantage is much faster results. The 
program you produce will be as fast as possible (assuming 
you have done a good job with it), and you can take 
advantage of all the features of the Amiga directly because 
you are working with the machine on a level very close to 
its own Is and 0s. 



T**r&<? /WW*, Borland International ("OQ^ SCUIUS VaUcy 

Drive, Scotts Valley, CA 95066) has introduced its version 
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time-consuming, Tecmar also manufacturers the T-tape T ". This $595 
tape system can back up the contents of the hard disk in a relatively 
short time. Because you can back up 20 megabytes in just a few 
minutes, using the T-tape is an easy way of ensuring that your in- 
formation won't be destroyed accidentally by a power surge or com- 
puter failure. 

One other Tecmar product that is a good way to expand your Amiga 
is the $799 multifunction expansion module, the T-card T ". This card 
will expand the memory of your computer to a mil megabyte (in 
other words, you will have twice as much memory to work with) 
rhe T-card also will give you a full-time clock-calendar, a standby 
l-ttery in case the power goes dead, a serial and a parallel port for 
extra add-ons, and a hard disk interface. You will need this card if 
you plan to get die T-disk hard disk drive. 

One of the most exciting features about the Amiga is that it can run 
software made for the IBM PC. The Tmmpcard®, an add-on from 
Commodore-Amiga, costs $ and the 5 1/4-inch disk drive (which 
most IBM PC diskettes work with) costs $325. With these extras 
the Amiga can run most IBM PC software just as fast (and sometimes 
faster) than a PC. The advantage of «his capability is the great amount 
of powerful software made for the IBM PC. An Amiga owner needing 
a particular piece of software can have thai seed satisfied simply by 
going to an IBM software dealer. Although the compatibility of the 
Amiga with the IBM PC probably will not put a dent in PC sales 
the fact that you have a wealth of software already available makes 
the Amiga an even more worthwhile machine. 

Commodore-Amiga has other add-ons that enhance the graphics and 
sound capabilities of the Amiga. The Genlock Interface®, for ex- 
ample, will merge your computer with a videocassette recorder You 
can superimpose images from your computer on video signals on 
the videocassette tape so that when the tape is played back both 
the television signal and the computer graphics are on the screen 
The Digitizer® has the reverse function: you can take a video image 
(from a video camera, the television, or a videocassette recorder) 
and have the Amiga "digitize" the picture into computer graphics 
(see fig. 10.6). Once you have the graphics on the screen, you can 
alter the graphics to create whatever effect you want. 

As far as sound is concerned, the MIDI interface in your Amiga can 
be hooked up to sophisticated synthesizers to produce sounds you 
have never heard before. Although the Amiga probably won't be 
111 "V w * rocK ^ time soon, you can create your own 
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Fig- A digitized picture of 
prog.^.wrs at Electronic Arts. 




sophisticated songs and sounds with the help of the Amiga and 
Cornmodore-Amiga's musical keyboard. You even can connect ,-ore 
Seated synthesis (such as those from Roland or Sequent 

la" t0 6 ^ St ° re S ° UndS M ™& « * e 

As powerful as the Amiga is, you always can find room for improve- 
ment. You now know several ways to give the Amiga more memory 

of other products is sure to be introduced for this machine One 
way to keep up with all the changes is by subscribing to a magazine 

WorUi (8C ftne Street, Peterborough, NH 03458). This is an fx- 
HHefrl ^ ^ ^ ° f COl ° r P hotos informative Z 

or-be^'T ^aT Sh ° U,d C ° nSider **** a C °~" 
the « v u ga USefS P™* m order to k eep up with all 

the excitmg changes and improvements in the Amiga system. 

Your Future with Amiga 

The Amiga personal computer was introduced at a time when many 
people were giving up hope for home computers. Indeed mavbe 
not everybody needs a eo mp „^ on the JXJ iSuStol 
ah people need to use spreadsheets, word processors, and telecom 
mumcations to keep their lives in order. telecom 
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However, you will soon discover that a personal computer gives you 
a decided advantage in your work and life. A computer makes tasks 
easier and less time-consuming, and in many cases you will find that 
what used to be work is now run. More important, by using your 
Amiga regularly, you will be prepared for all the exciting events of 
the near future; you will have a head start by understanding what 
a computer can do for you and having a machine do repetitive, 
boring work that you shouldn't have to do. 

You no have the knowledge to use and program your system suc- 
cessful to build on your computer later. The Logo, Amiga 
BASIC, and triages will give you a firm foundation for writing 
programs now and tor moving on to other languages. In addition, 
your knowledge of the availabie hardware and software tools will 
let you customize your Amiga to suit your needs. Remember that 
your Amiga is a tool that can help you improve yourself, enjoy your 
work and free time more, and teach yourself -bout exciting new 
worlds in high technology. 
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1-2-3 software package, 256 
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A Mind Forever Voyaging software package, 265 
ABS function, 40 
addition, 38, 176 

Aegis Draw software package, 260 

alignment of data, 69 

ALL command, 164 

ALT key, 13 

Amiga 

compatibility with IBM PC, 256 

Trumpcard, 268 
components, 6-7 
Copper Processor, 182-186 
distribution disks, 7 
enhancements, 267-268 
input and output devices, 11-13 
learning to program, 2, 29, 135-136 
multitasking capability, 21, 121, 132, 169 
overview, 2 
owner's manual, 5 
public domain programs, 250 
servicing, 11 
setting up, 6-10 

software available for, 124, 246 248, 256-265 
speed of operation, 101, 106 
sprites, 180-182 

use by handicapped persons, 133-134 
word-processing applications, 245-249, 258 
Amiga BASIC, 2, 7, 31 
AREA command, 92-94 
AREAFILL command, 92-94 
art generation, 95-96, 102-103 
ASC function, 47 
Bear Face program, 95-96 
block manipulation, 75, 107-108 
CHRJ function, 48 
CIRCLE command, 90-92, 107 
CLS command, 52 
COLOR command, 86, 88 
counting, 49-50 
OjlTTil luiuiiuum, OJKH 
deleting program lines, 76 
ELSE command, 58-59 
ERASE command, 74 
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GET command, 10 j ^ ■ 

GOSUB command, 48-49 

GOTO command, 32-33, 48 

IF...GOTO command, 55 

IF...THEN command, 56 

IF..THEN GOTO command, 56 

IN KEY! command, 62-63, 113 

INPUT command, 60-61 

INSTR function, 47 

LEFT! command, 46-47 

LEN function, 44 

LINE command, 80-82, 85-87, 105, 107 

bar graphs, 88 

line graphs, o3-84 
LINE INPUT connnand, 62 
line numbers, 32 
UST command, 76 
List window, 29, 74-75 
LOAD command, 77 
LOCATE command, 53, 66-67 
logical operators, 56-58 
loops, 49-53, 81 
mathematical operations, 38-43 
menu bar, 29-30 
MERGE command, 77-78 
MOUSE commmand, 103-106 
ON ERROR GOTO command, 59-60 
ON...GOSUB command, 59 
ON...GOTO command, 59 
Output window, 29 
PALETTE command, 85, 103, 114-116 
PATTERN command, 97-100, 108-1 10 
pixels, 79-80 

PRINT command, 34, 65-66 

PRINT USING command, 67-70 

PUT command, 102-103, 108 

READ command, 63-64 

REM statement, 33 

REPLACE command, 77 

RESTORE command, 64-65 

row and column numbers, 66-67 

RUN command, 30 

SAVE command, 77 

SAY command, 130 133 

slowing down program execution speed, 101 

SOUND command, 120-121 

SPACE* function. 46 

speed of program execution, 167 

stopping execution of a program, 33 

STRt function, 45 

STRING! function, 45-46 
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Superbear program, 102-103 

TRANSLATE* command, 129-130 

use of numbers, 36-37, 40 

VAL function, 45 

variables, 35-37 

WAVE command, 126-129 
Amiga Extra? disk, 7 
Amiga key, 13 

Amiga KOM Kerned Manual, 211-212 
AmigaDOS, 213 

accessing, 214 

advanced commands, 233 

CD command. 221-222 

COPY command, 228-229 

DATE command, 220 

DELETE command, 230-231 

DIR command, 216-219 

DISKCOPY command, 228 

ECHO command, 224 

ED command, 234-236 

ENDCL1 command, 234 

EXECUTE command, 237-239 

FAILAT command, 242 

FAULT command, 225-226 

FILENOTE command, 230 

FORMAT command, 226 
heirarchical directories, 214-216, 219 
IF command, 239-240 
increasing efficiency of, 233 
INFO command, 223 
LNSTALL command, 227 
JOIN command, 231 
LAB command, 238 
'1ST command, 220-221 
MAKEDIR command, 221 
NEWCU command, 233-234 
prompt, 218 
PROMPT command, 224 
PROTECT command, 231 
QUIT command, 242-243 
RELABEL command, 227 
RENAME command, 229 
SEARCH command, 243 
SKIP command, 238 
TYPE command, 224-225 
WAIT command, 244 
WHY command, 225 
AmigaWorid magazine, 211, 269 
AND logical operator, 56 

animation capabilities of Amiga, 93-94, 102-103 

use of CLS command to create movement, 106 
ANY' command, 164 
Archon software package, 262 
Arcticfox software package, 263 
AREA command, 92-94 
AREA FILL command, 92-94 
arrays, 71-73 

DIM command, 73-74, 101 

dimensions, 72-73 

erasing, 74 

GET command, 101 

HOW%( ), 131-133 

music generation, 124-126 

OPTION BASE command, 73 

PUT command, 102-103, 108 



saving a graphics image in an array, 101-102 
an generation, see graphics capabilities of Amiga, art 
artificial intelligence prograrnming. 135 
ASC function, 47-48 
ASCII, 45^6 

CH command of TLC Logo, 155-156 

character set explained, 47 

CHRI function, 48 
ASK command, 148 
aspect variable, 90-91 
Assembler programming language, 266 
assigning a value to a variable 

LET command, 71 

SWAP command, 71 
asterisk (*) operator, 38 
asterisk («) prim alignment character, 69 
ATN function, 41 
available memory, 27 
Aztec C software, 170 



n 

B command, 143 
back gadget, 20, 27 
background color, 86, 14 / 
backing up a disk, 22", 

DISKCOPY command, 228 
BACKSPACE key, 13, 74-75 
backward counting, 50 
bar graphs, 88 

base 10 numbering system, 96 
base 16 numbering system, 96 

base 2 numbering system, see binary numbe.^ smxm 

BASIC programming language, see Amiga BASIC 

batch file processing, see command sequences 

baud rate, 25, also see telecommunications 

BF command, 1 57 

binary numbering system, 96-100 

bits, 97 

BK command, 136-137, 142 

BL command, 157 

Blitter Screen program, 186-189 

Butter with the Mouse program, 205-211 

block manipulation, 107-108 

COPY option, 75 

CUT option, 75 

PASTE option, 75 
bold type, 23 

booting the Amiga, 10, 227 

border color, 94, 111 

box graphic generation, 86-87 

boxes within boxes, 89 

random boxes, 87 

using mouse, 104 
Boxer Window, 21 

bulletin board services, 250, also see telecommunications 

menu options, 251-253 
business software for the Amiga, 256 

Enable, 258 

Maximillian, 258 

MaxiWord, 258 

Kaas tn RiVhpe 757 
VIP, 258 

bvtes, 97 
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c 

C programming language, 2 
#include statement, 1 76 
Butter Screen program, 186-189 
Blitter with the Mouse program, 205-211 
compiled language, 168- 169 
conversion character, 175 

Copper Processor Disassembler program, 182-186 

data types, 177 

features of C, 171-172 

format specifier, 175 

gets function, 176 

Lattice C, 176. 178 

iiL->t, functions, 170, 174 
, -,m( ) function, 172 

ManQt.' *-at Explorer program, 189-197 

mathematical functions, 176 

Mouse Function program, 198-200 

Mouse Sprite program, 202-205 

New Screens program, 200-202 

object code, 169 

overview, 167-168 

printf command, 173-174 

puts function, 176 

random number generation, 177 

reasons for popularity, 167-168 

scanf command, 174 

Simple Sprite program, 180-182 

source code, 169 

stpchr function, 178 

strcat function, 178 

strcmp function, 177 

strcpy function, 178 

strlen function, 177 

strncat function, 178, 180 

Temperature program, 171 

variables, 172-173 

while command, 173-174 

Window Maker program, 179 

writing a program, 169-171 
CAPS LOCK key, 12 
carat ( A ) operator, 38 
CB radio, 255 
CD command, 221-222 

Celsius temperature calculation program, 171-175 

CH command, 155-156 

channel, 131 

characters per line, 25 

children's use of Amiga, 135-136 

chord generation, 126 

CHR* function, 48 

CIRCLE command, 90, 92, 107 

aspect variable, 90-91 

cone generation, 91 

ellipse generation, 90 

radius, 90 
Clean Up option, 17 
clearing the screen, 65 

CU (Command Line Interface), see AmigaDOS 
Clock tool, 22 

close cadeer. 1Q 
Close option, 17 
closing a window, 234 
CIS command, 52 



use in creating impression of movement, 106 
colon (:) character < 
as a command-linking character, 36 
in TIC Logo programming language, 146-147 
COLOR command, 82, 86, also see PALETTE command 

determing the color of an individual pixel, 86 
Color Finder program, 1 14-117 
column numbers, 66-67 
combining strings, 44 
comma (,) character 

as a print formatting character, 69 
use in TLC Logo, 161 
Command Line Interface, 26 
command sequences, 233 

EXECUTE command, 237-239 -r if 

IF command, 239-240 
terminating upon error, 242 
commands 

AREA, 92-94 
AREAFILL, 92 94 
CD, 221-222 
CIRCLE, 90-92, 107 
CLS, 52, 65, 106 
COLOR, 82, 86, 88 
COPY, 228-229 
DATA 63-64, 122-123 
DATE, 220, 222-223 
DELETE, 76, 230 231 
DIM, 73 74, 101 
DIR 214-219 
DISKCOPY, 228 
ECHO, 224 
tiD, 234-236 
ELSE, 58-59 
ENDCLI, 234 
ENDIF, 240 242 
EQ, 240 
ERASE, 74 
FAILAT, 242 
FAULT, 225-226 
FILENOTE, 230 
FOR. NEXT, 150 
FORMAT, 226 
GET, 101 
GOSUB, 48-49 
GOTO, 32-33, 48 
IF .GOTO, 55 
IF.. .THEN, 56 
IF.., THEN GOTO, 56 
INFO, 223 
INPUT, 60-61 
INSTALL, 227 
JOIN, 231 
LAB, 238 
LEFTI, 46-47 
LET, 71 

LINE, 80 88, 105, 107 

bar graphs, 88 

line graphs, 83-84 
LINE INPUT, 62 
LIST, 76, 220-221 

I-OVC, 77 

LOCATE, 53, 66-67 
MAKEDIR 221 
MERGE, 77-78 
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MOUSE, 103-106 
NEWCLI, 233-234 
ON ERROR GOTO, 59-60 
ON . GOSUB, 59 
ON...GOTO, 59 
OPTION BASE, 73 
PAINT, 91-96 

PALETTE, 85, 103, 114-116 

PATTERN, 97- 1 00, 3 08-110 

POINT, 86 

PRINT, 34, 65-66 

PRINT USING, 67-70 

PROMPT, 224 

PROTECT, 231 

PUT, 102-103, 108 

QUIT, 242-243 

READ, 63-64 

RELABEL, 227 

REM, 33 

RENAME, 229 

REPLACE, 77 

RESTORE, 64-65, 126 

RND, 87 

RUN, 30 

uAVE, 77 

aAV, 130-133 

SEARCH, 243 

SKIP, 238 

SOUND, 120-121 

SWVih 71 

text editing, 234-236 

TRANSLATE*, 129-130 

TYPE, 224-225 

WAIT, 244 

WAVE, 126-129 

WHY, 225 
comments added to file names, 230 
comments in C language programs, 172 
Commodore computer, 124 
communications, see telecommunications 
compiled languages, 167-169 
components of the Amiga, 6 

hooking up, 8-10 

keyboard, 7, 11-13, 112-114 

main unit, 7 

mouse, 7, 103-106 

video monitor, 9-10 
composite video monitor, 9 
CompuServe, 250, 253 

CB radio, 255 

The Multiple Choice, 254 
computer crime, 255 256 
computer databases, 250, 253 255 
cone graphic generation, 91 
conversion character, 175 

Copper Processor Disassembler program, 182-186 
Copy edit option of Notepad menu, 23 
copying 

blocks, 75 

COPY command 228 
QUIET option, 229 

disks, 17 
CUS function, 41 
counting, 49 



backward, 50 

increments, 50 
CS command, 144 
CTRL key, 13 

CTRL-C key sequence, 33, 76 
cube graphic generation, 84-85 
cursor movement, 12 
scroll arrows, 20 
customized keywords of TLC Logo, 140-142 
Cut edit option of Notepad menu, 23 
On" option for block manipulation, 75 

nr.-. D 
bat : «jj ■ . 

~% iflg, 69 

retrieving, ^2-64 

storing, 71 
DATA command, 63-64, 122-123 
data types of C programming langi- , <^g■^ 177 
date and time functions, 24-25 

DATE, 220, 222-223 
decimal point, 68 
decision-making programs, 55 

IF command 239-240 

TLC Logo, 160-161 
DELAY command, 151 
DELETE command 76 

QUIET option, 230-231 
Deluxe Video Construction Set software package, 262 
Demos window, 21 
Digitizer, The, 268 
dimensions, 72-73 

DIM command, 73-74, 101 
DIR command, 153-154, 214-218 

hierarchical directories, 214-216 

root directories, 214-216, 219 
Discard option, 17 
Disk menu 

Empty Trash option, 17 

Initialize option, 17 
DISKCOPY command, 228 
disks 

backing up, 17, 227-228, 268 

disk drive, 13 

Disk Gauge, 20 

disk icon, 18 

ejecting, 14-15 

formatting, 17, 226 

hard, 267 

input and output commands, 77 

making a disk bootable, 227 

RELABEL command 227 

removing from the drive, 10 

storage capacity, 1 3 

write protection, 13 
Display Centering, 26 
displaying a disk directory, 18, 214-216 
distribution disks of Amiga 

Amiga Extras, 7 

Kickstart, 7, 14, 211-212, 214 

division, 38, 176 
dollar sign (t) 
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as a print formatting character, 69 

as a variable type indicator, 43 
DOS, see AmigaDOS 
DOT command, 145 
Dotty Window, 21 
Double-Click Delay, 25 
double-precision variables, 37 
drag bar, 19 
dragging an icon, 15-16 
drawer icon, 18, 21 

drawing a picture, see graphics capabilities of Amiga, art, 95 
Duplicate option, 17 

duration setting «br sound generation, 121 
E 

E command 143 
ECHO command 224 
ED command, 234 

other editing commands, 235-236 
Edit options of Notepad menu 
Copy, 23 
Cut, 23 
Erase, 23 
Paste, 23 
Undo, 23 
Edit Pointer, 26 
editing a program, 74-76 
electronic mail, 253-254 
elements of TLC Logo, 156 
ellipse graphic generation, 90 
ELSE command, 58-59 
EMACS text-editing program, 170 
Empty Trash option, 17 
Enable software package, 258 
Enchanter software package, 265 
END command, 14 1 
ENDCLI command 234 
ENDIF command, 240-242 
enhancing the Amiga, 267 
Genlock Interface, 268 
The Digitizer, 268 
Tnimpcard, 268 
ENTER key, 13 
EQ command, 162, 240 
equal sign (=) character 

as a variable assignment character, 71 
use in TLC Logo, 161 
EQV logical operator, 58 
ERA command 154-155 
ERASE command 74 
Erase edit option of Notepad menu, 23 
ERROR statement, 240 
error trapping 

FAELAT command, 242 
FAULT command, 225-226 
in command sequences, 242 
tolerance level, 242 
WHY command, 225 
exclamation point (!) variable type indicator, 37 
EXECUTE command 237, 239 

SKIP command 238 
EXISTS statement, 240 



EXP function, 41 1 
expanding a window, 20 
exponentiation, 37-38, 176 

F 

F command 143 

FACE command 144-145 

Fahrenheit temperature calculation program, 171-175 
FAIL statement, 240 
FAILAT command 242 

QUIT command 242-243 
FAULT command 225-226 
FD command, 136-137, 142 
female voicing, 131 
file management 

Clean Up option, 17 
COPY command 228-229 
DELETE command 230-231 
Empty Trash option, 17 
ilLENOTE command, 230 
JOIN command 231 
PRUIECT command 231 
kc'irtME command 229 
TLC Logo programming language 
DIR command 153-154 
FRA command 154-155 
LOAD rommand 153 
SAVE command 153 
FILENOTE command, 230 
files 

searching for text, 243 

transferring from one window to another, 22 
finding the right color, 114-117 
FIRST command 157-158 
Coating-point numbers, 173 
flood filling a solid shape, 94-96 
fonts, 23 

FOR command 150 

FOR NEXT command 150 

FOR ..NEXT loop, 49-53 

boxes within boxes, 89 

LINE command 81 
foreground color, 86 
format specifier, 175 
formatting 

disks, 17, 226 

FORMAT command 226 

Format option of Notepad menu, 24 

numbers, 67-70 

PRINT USING command 67-69 
TAB function, 70 
FPUT command 158 

frequency setting for sound generation, 120 
front gadget, 20, 27 
function keys, 11-12 

on Text craft word-processing program, 248 

G 

game software for the Amiga, 261 
A Mind Forever Voyaging, 265 
Archon, 262 
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mouse, 13-15, 103-106 
INSTALL command, 227 
INSTR function, 47 
INT function, 40, 159-160 
int variables, 37, 172-173 
interpreted programming languages, 167-168 
ISEMPTY command, 163164 
italic type, 23 



JOIN command, 231 



Key Repeat Delay, 25 
keyboard 

ALT key, 13 

Amiga key, 13 

BACKSPACE key, 13, 74-75 

CAPS LOCK key, 12 

CTRL key, 13 

cursor-movement keys, 12 

ENTER key, 13 

function keys, 11-12 

musical keyboards, 260 

numeric keypad H, 112-114 

repeating key function, 25 

storing, 8 

use as a graphics input device, 112-115 
keywords, 140-142 
DFLAY : 151 
FOR, 130 
HELP, 153 
PRINT, 152 
PT, 152-153 
RC, 151 

REPEAT, 149-150 
RL, 151 
Kickstart disk, 7, 14, 214 

ROM Kernal Manual, 211-212 



L command, 143 

LAB command, 238 

LAST command, 157-158 

Last Error option, 18 

Lattice C, 176-178 

Learning Company, The, 135 

learning to program, 2, also see Amiga BASIC 
practice session, 52, 53 
programming language alternatives, 266 
TLC Logo programming language, 135-136 
writing decision-making programs, 55, 160-161 

LEFTS command, 46-47 

LEN function, 44 

LENGTH command, 156-157 

LET command, 71 

library functions of C programming language, 170 174 
LINE command, 80-88, 105, 107 

uu grapns, 85 

line graphs, 83, 84 



line numbers in program files, 32 
Lines Window, 21 
LISP programming language, 266 
LIST command, 76, 220, 221 
List window, 29, 74-75 
LOAD command, 77, 153 
LOCATE command, 53, 66-67 
LOG function, 41 
logical operators, 56 

AND, 56 

EQV, 58 

OR, 56-58 

XOR, 58 

Logo, see TLC Logo programming language 
loop?, 33, 48 

FOR..NEXT, 49-53, 81, 89 

nested, 50-52 
LOWER command 155 
LPUT command, 158 
LT command, 136-137, 142 
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main( ) function, 172 
MAKE command, 156-157 
MAKEDIR command, 221 
male voicing, 131 

Mandelbrot Explorer program, 189-197 
mantissas, 37 
mathematical operations 
Amiga BASIC, 38 
ABS function, 40 
ATN function, 4 1 
COS function, 4 1 
EXP function, 41 
INT function, 40 
LOG function, 41 
MOD function, 39 
operators, 38-39 
RND function, 42-43 
SGN function, 40 
SIN function, 41 
SQR function, 39 
TAN function, 41 
C language, 176 
TLC Logo 

INT function, 159-160 
NEG function, 159 
PI function, 160 
REM function, 160 
RN function, 160 
SORT function, 160 
MAX command, 1 62 
Maximillian software package, 258 
MaxiWord software package, 258 
MEMBER command, 163 
memory available, 27 

expanding memory, 268 
menu bar, 16 

in Amiga BASIC, 29-30 
MERGE command, 77-78 

mirfi^procefisop, 2 

MIDI interface, 260, 268 
MTN command, 162, 163 
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random waveform, 127-129 

RC command, 151 

READ command, 63-64 

rebooting the Amiga, 10, 227 

Redraw option, 18 

reducing the size of a window, 20 

RELABEL command, 227 

HEM function, 33, 160 

RENAME command, 229 

Rename option, 17 

REPEAT command, 141, 149-150 

REPLACE command, 77 

Reset Colors, 26 

RESTORE command, 64-6' 126 

retrieving data 

using INKEYI command, 62, li., 

using READ and DATA commands, 63-6* 

Return to Atlantis software package, 263 

RGB monitor, 9 

RL command, 151 

RN function, 160 

RND function, 42-43, 87 

ROM memory, 183 

root directories, 214-216, 219 

row numbers, 66-67 

RT command, 136-137, 142 

RUN command, 30 



S command, 143 
"ample Amiga programs, 52-53 
sound generation, 121-122 
Save As project option of Notepad menu, 23 
SAVE command, 77, 153 
Save project option of Notepad menu, 23 
SAY command, 130 

voice changes, 131-133 
scanf command, 174 
scientific notation, 37 
scratch pad, see Notepad tool 
scrolling 

pausing a scroll, 76 

scroll arrows, 20 
SEARCH command, 243 
seed, 42 

semicolon (;) character 

as pan of PRINT command, 34 
in AmigaDOS, 218 

in TLC Logo programming language, 146-147 
sequenced commands, 233, 237-240, 242 
servicing the Amiga, 1 1 

setting foreground and background colors, 86 
setting up the Amiga, 6-10 
Seven Cities of Gold software package, 262 
SGN function, 40 

showing a disk directory, 18, 214-216 
shrinking a window, 20 
Simple Sprite program 180- 182 
SIN function, 41 



sizing gadget, 20 
SKIP command, 238 
Skyfox software package, 262 



slash (/) character 
as an operator, 38 
in AmigaDOS, 219 

use in C programming language, 172 
slowing down program execution speed, 101 
snoring icon, 20 
soft boot, 10, 227 
software available for the Amiga 

A Mind Forever Voyaging, 265 

Aegis Draw, 260 

Archon, 262 

Arcticfox, 263 

Deluxe Video Construction Set, 262 
Enable, 258 
Enchanter, 265 
Graphicraft, 259-260 
Harmony, 261 

IBM PC emulation, 256-257, 268 

interactive fiction games, 264 

Maximillian, 258 

MaxiWord, 258 

Music Construction Set, 260 

Musicraft, 124 

One-on-One, 262 

PlanetM, 265 

pir>giamminfe language alternatives, 266-267 

Rags to Riches, 257 

Return to Atlantis. 263 

Seven Cities of Gold, 262 

Skyfox, 262 

Suspect, 265 

Textcraft, 246-248 

VIP, 258 

Wishbringer, 264 

Zork series, 264 
software piracy, 255-256 
software reset, 10, 227 
solid shapes and patterns, 92-94 

flood filling, 94-96 

PATTERN command, 97-100, 108-110 
sound generation capabilities of Amiga, 2, 
Amiga monitor, 9 

Out of Uorkspace error message, 121 
output and input ports, 119 
SOUND command, 120 
duration setting, 121 
frequency setting, 120 
sample programs, 121-122 
voice setting, 121, 126 
volume setting, 121, 123 
waveform, 126-129 
stereo sound, 10, 119-120, 123 
sound waves, see waveform 
source code, 169 
SPACE» function, 46 
speaking rate, 131 
Special menu 

Clean Up option, 17 
Last Error option, 18 
Redraw option, 18 
speech generation capabilities of Amiga 
interrupting speech, 133 
SAY command, 130 
TRANSLATE* command, 3 29-130 
voice changes, 131-133 
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speed of operation of Amiga, 106 

slowing down, 101 
sprites, 180-182 
SQR function, 39 
SQRT function, 160 
SS command, 148 
status symbols, 231 

stereo sound capabilities of Amiga, 10, 119-120, 123 
stopping execution of a program, 33 
storage capacity of 3 1 /2-inch disk, 13 
Disk Gauge, 20 

increasing overall storage by adding hard disk, 267 
stpchr function, 178 
i function, 45 
function, 178 
sircmp function, 177 
su-cpy function, 178 
strengths of Amiga, 2 
string variables, 43 
combining, 44 
LEN function, 44 
null string, 63 
VAL function, 45 
STRING! function, 45-46 
strien function, 177 
strncat function, 178, 180 
subdirectories, 214-216, 219 
CD command, 221-222 
MAKEDIR command, 221 
subroutines, 48 

Subscript out of Range error message, 73 

subtraction, 38, 176 

sunburst graphic generation, 85 

surge protector, 6 

Suspect software package, 265 

SWAP command, 71 

Symphony software, 256 

system unit, 7 



T-card, 268 
T-disk, 267 
T-modem, 249 
T-tape, 268 
TAB function, 70 
TAN function, 41 
telecommunications 

1200 RS modem, 249 

abuses, 255-256 

baud rate, 25 

bulletin board services, 250-253 

host computer, 250 

modem, 249-250 

T-modem, 249 
television 

use as Amiga monitor, 9 
Temperature program, 171-175 
text commands 

ED, 234-236 

searching for text, 243 

TLC Logo 

CH, 155-156 
LOWER, 155 



UPPER, 155 
Text Size, 25 

Text craft word-processing program, 246-247 

function keys, 248 
The Source computer database, 250, 253-254 
tile shape characteristic of TLC Logo programming language, 139 
time arid date functions 

DATE, 222-223 
timekeeping capability of Amiga, 22 
TLC Logo programming language, 2, 135 
commands 
ASK, 148 
ALL, 164 
ANY, 164 
B, 143 
BF, 157 

BK, 136-137, 142 
BL, 157 
CH, 155-156 
CS, 144 
DELAY, 151 
DIR, 153 154 
DOT, 145 

E, 143 
END, 141 
EQ, 162 
ERA, 154-155 

F, 143 

FACE, 144-145 
FD, 136-137, 142 
FIRST, 157-158 
FOR, 150 
FPUT, 158 
GS, 148 
HATCH, 148 
HD, 138 
HELP, 153 
ID, 149 
IFFALSE, 165 
IFTRUE, 165 
INK, 140, 147 
ISEiMPTY, 163-164 
L, 143 

LAST, 157-158 
LENGTH, 156-157 
LOAD, 153 
LOWER, 155 
LPUT, 158 
LT, 136-137, 142 
MAKE, 156-157 
MAX, 162 
MEMBER, 163 
MEN, 162-163 
MTNUSP, 163 
N, 143 
NTH, 158 
PAPER, 147 
PENDOWN, 139 
PENERASE, 139 
PENUP, 139 

POS, \ii 
primitives, 141 
PRINT, 152 
FT, 152-153 
R, 143 
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RC, 151 

REPEAT, 141, 149 150 
RL, 151 

RT, 136-137, 142 
S, 143 
SAVE, 153 

SHAPE AIRPIANE, 139 
SliAPEARROW, 139 
SS, 148 

TILE:HEAKr, 139 
T1L£:UNE, 139 
TM, 147-148 
TO, 143 
TS, 148 

TURTLE :HIDE, 138 
TURTLE SHOW, 138 
UPPER, 155 
W, 143 
ZEROP, 163 
elements and objects, 156 
INT function, 159-160 
NEG function, 159 
PI function, 160 
REM function, 160 
RN function, 160 
special symbols, 146-147 
SORT function, 160 
turtle graphics, 136-137, 140, 142-143 

characteristics of turtle, 137-139 
user-defined keywords, 140-142 
variables, 141-142 
TM command, 147-148 
TO command, 143 
tool icoi=, 

Clock tool, 22 
Notepad tool, 22-24 
Preferences tool, 24-27 
transferring files from one window to another, 22 
TRANSLATE* command, 129-130 
Trashcan icon, 15, 18 
trigonometric functions 
C language, 176 
TLC Logo, 160-161 
Trumpcard, 268 
TS command, 148 

Turbo Pascal programming language, 266 

„ Turbo Tutor, 267 
turtle graphics, 136-137, 142 
characteristics of turtle, 137 
heading, 138 
pen state, 139 
tile shape, 139 
turtle shape, 139 
visibility, 138 
INK command, 140, 147 
moving the turtle, 136-137, 142-145 
multiple turtles, 148 
TM command, 147-148 
TYPE command, 224-225 
typestyle, 23 
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underline type, 23 

Undo edit option of Notepad menu, 23 
UPPER command, 155 
uppercase letters, 12 

in programs, 31, 155 
user-defined keywords of TLC Logo, 140-142 



VAL function, 45 

Values in error. Please chock ajaln screen message, 59 
Values uerifled screen message, 59 
-ariables, 35-36 

Trays, 71-73 

aspect variable, 90-91 

ciouole-piecision, 37 

float, 173 

in TLC Logo, 141 K'7 
int type, 172 
integer, 37 
LET command, 71 
single-precision, 37 
string, 43-45, 63 
SWAP command, 71 

use in C programming language, 172-173 
video monitor 

Amiga monitor, 9 
clearing the screen, 65 
composite, 9 
icon, 14-16 

measured in pixels, 79 
menu bar, 16 

numbered rows and columns, 66-67 

screen control commands of TLC Logo proerammina 
language, 148 

Text Size option, 25 
videocassette recorder 

use with Amiga, 268 
VIP software package, 258 

visibility characteristic of TLC Logo programming language 138 

vocal quality, 131, 133 

voice setting for sound generation, 121, 126 

volume 

in speech generation programs, 131 
volume setting for sound generation, 121, 123 



W command, 143 
WAIT command, 244 
WARN statement, 239 
waveform 

altering, 126-129 

graphic representation of, 127-128 

random. 127-129 
white command, 173-174 
WHY command, 225 
Window Maker program, 179 
nillUUWS, 10 

ENDCLI command, 234 

manipulating, 21 
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NEWCU command, 233-234 
parts, 19-20 
Wishbringer software package, 264 
word processing on the Amiga, 245 
MaxiWord, 258 
Textcraft, 246-249 
Workbench disk, 7, 15 
Workbench menu, 17 
Close option, 17 
Discard option, 17 
Duplicate option, 17 
Info option, 17 
Open option, 17 
option, 17 
Won " -nch wiry-jw, 18, 213 
back B - 2u, 27 
close gadget, i j 
disk gauge, 20 
disk icon, 18 
drag bar, 19 
drawer icon, 18, 21 
error trapping, 225-226 
front gadget, 20, 27 
parts of the window, 19-20 
program file icon, 18 
scroll arrows, 20 
sizing gadget, 20 
tool icon, 18 
Clock tool, 22 
Notepad tool, 22-24 
Preferences tool, 24-27 
transferring files, 22 
Trashcan icon, 15, 18 
write-protecting a disk, 13 

X, Y, 2 

X-Y coordinates, 80 

X-Y coordinates, 79 also see graphics capabilities of Amiga 
XOR logical operator, 58 
ZEROP command, 163 
Zork scries software, 264 
Zs icon, 20 



278 



AMIGA PROGRAMMING GUIDE 



minus sign (-) operator, 38 
MINUSP command, 163 
MOD function, 39 

modem, 25, 249-250, also see tdtcommunications 

abuses, 255-256 
•monitor, see video monitor 
mouse, 7, 13-15, also see cursor movement 

drag bar, 19 

Mandelbrot Explorer program, 189-197 

MOUSE command, 103 

Mouse Function, 198-200 

Mo ;se Sprite program, 202-205 

Mouscpad accessory, 9 

speed. 2j . : 
— in g,.'^h>~s generation, 103-106 
Mouse i " ! on program, 198-200 
Mouse Sprite pi\, t ^m, 202-205 
moving the cursor, see cursor movement 
MS-DOS operating system, 213 
Multiple Choice, The, 254 
multiple turtles, 148 
multiplication, 38, 176 
multitasking, 21 

simultaneous generation of sound with other tasks, lil. 132 

use of C programming language, 169 
Music Construction Set software package, 260 
music capabilities of Amiga, 2, 119 

chords, 126 

Commodore computer keyboard, 124 
DATA command, 122-123 
Harmony software package, 261 
MIDI interface, 260, 268 
musical keyboards, 260 
pitch, 122-124 
stereo sound, 123 
use of arrays, 124-126 
waveform, 126-129 
Musicraft program, 124 



N 

N command, 143 
NEC function, 159 

negative number-to-positive number conversion, 40 
negative sign (-) print formatting character, 68 
nested loops, 50-52 

New project option of Notepad menu, 23 
New Screens program, 200-202 
NEWCU command, 233-234 
Non-Graphics Mode error message, 148 
Notepad tool, 22 

Edit options, 23 

Font options, 23 

Format options, 24 

Project options, 23 

Style options, 23 
NTH command, 158 
NTSC monitor, 9 
null string, 63 

numbers in Amiga BASIC, 36-37 

base 10, 96 
base 16, 96 
base 2, 96 



converting a number into an ASCII string, 45 
converting negative numbers to positive, 40 
formatting, 67-70 
■ random numbers, 42-43, 53, 87 
numeric keypad, 1 1 

use as a graphics input device, 112-115 



O 

object code, 169 

objects of TLC Logo, 156-158 

ON ERROR GOTO command, 59-60 

ON...GOSUB command, 59 

ON...GOTO command, 59 

One-on-One software package, 262 

Open option, 17 

Open project option of Notepad menu, 23 
opening a window, 233 
operating speed of. Amiga, 106 

slowing down, 101 
operators, 38-39 

logical, 56-58 
OPTION BASE command, 73 
OR logical operator, 56-58 
Out of Uorkspae* error message, 121 
Output window, 29-30 
owner's manual of Amiga, 5 
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PAlAT -imrnsnd, 91-92, 94-95 

art generation, 95-96 
PALETTE command, 85, 103, 114-116 
PAPER commaand, 147 
Pascal programming language, 266 
Paste edit option of Notepad menu, 23 
PASTE option for block manipulation, 75 
PATTERN command, 97-100, 108-110 

pen state characteristic of TLC Logo programming language, 138- 
139 

percentage sign (%) variable type indicator, 37 
phonetics, 129 

TRANSLATE* command, 130 
PI function, 160 

picture generation, see graphics capabilities of Amiga, art 
pitch, 122-124 

in speech generation programs, 131 
pixels, 79-80 

bar graphs, 88 

determining the color of an individual pixel, 86 
flood filling a solid shape, 95-96 
plain type, 23 

Planetfall software package, 265 
plus sign (+) 

as a print formatting character, 68 

use as a mathematical operator, 38 

use in connecting strings, 44 
POINT command, 86 
pointing 

Edit Pointer function, 26 

mouse, 13-15 
polygon graphic generation, 92-93 

PATTERN command, 97-100, 108-110 
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